Tradera · Schema

ShopItemVariantData

Shop item data, represents a request to add an shop item to the Tradera system.

MarketplaceE-CommerceSecondhandAuctionsSweden

Properties

Name Type Description
title stringnull The title (short description) of the item (80 chars).
description stringnull A long (7000 chars) description of the item.
categoryId integernull The category Id. See the method !:PublicService.GetCategories for all available categories.
acceptedBuyerId integernull The types of Buyers allowed to buy the Item. See the method !:PublicService.GetAcceptedBidderTypes for a list.
shippingOptions arraynull A list of shipping options offered to the buyer of the Item. At most 3 shipping options are allowed if Pickup is included. Otherwise, at most 2 shipping options are allowed. See Tradera.Api.Services.C
paymentOptionIds arraynull An array of ids of Payment types (more than one can be specified). See the method !:PublicService.GetItemFieldValues for a list.
itemAttributes arraynull Item attributes like: New, Used
shippingCondition stringnull Describes Shipping condition for this Item (500 chars)
paymentCondition stringnull Describes Payment condition for this Item (500 chars)
ownReferences arraynull The sellers own references for this Item (60 chars).
vat integernull VAT for the item. The VAT value can be retrieved from API method !:PublicService.GetItemFieldValues.
itemImages arraynull Shop item images, an array of Tradera.Api.Services.Core.Contracts.Entities.ItemImageData objects (max 40 images). Max accepted size: 4MB
activateDate stringnull Date when Shop item will be active on Tradera.
deactivateDate stringnull Date when Shop item will be deactivated on Tradera.
quantity integernull Modify the available quantity for this Item. This is a delta and will be added to the current quantity. Use a negative value to decrease the quantity.
absoluteQuantity integernull Set the quantity to an absolute value, regardless of the current quantity. It is not allowed to provide both AbsoluteQuantity and Quantity in the same request.
externalId integernull The id of the item in external system.
price integernull Shop item price.
sellerPartNo stringnull Required id of the item in external system.
variantData object
attributeValues object
descriptionLanguageCodeIso2 stringnull The description language code of the item.
View JSON Schema on GitHub

JSON Schema

tradera-shop-item-variant-data-schema.json Raw ↑ 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/tradera/main/json-schema/tradera-shop-item-variant-data-schema.json",
  "title": "ShopItemVariantData",
  "description": "Shop item data, represents a request to add an shop item to the Tradera system.",
  "x-generated": "2026-10-15",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/tradera-openapi.json#/components/schemas/ShopItemVariantData",
  "type": "object",
  "properties": {
    "title": {
      "type": [
        "string",
        "null"
      ],
      "description": "The title (short description) of the item (80 chars)."
    },
    "description": {
      "type": [
        "string",
        "null"
      ],
      "description": "A long (7000 chars) description of the item."
    },
    "categoryId": {
      "type": [
        "integer",
        "null"
      ],
      "description": "The category Id. See the method\r\n!:PublicService.GetCategories for all available categories.",
      "format": "int32"
    },
    "acceptedBuyerId": {
      "type": [
        "integer",
        "null"
      ],
      "description": "The types of Buyers allowed to buy the Item. See the method\r\n!:PublicService.GetAcceptedBidderTypes for a list.",
      "format": "int32"
    },
    "shippingOptions": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "$ref": "#/$defs/ItemShipping"
      },
      "description": "A list of shipping options offered to the buyer of the Item. At most 3 shipping options are allowed if Pickup is included. Otherwise, at most 2 shipping options are allowed. See Tradera.Api.Services.Core.Contracts.Entities.ItemShipping."
    },
    "paymentOptionIds": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "integer",
        "format": "int32"
      },
      "description": "An array of ids of Payment types (more than one can be specified).\r\nSee the method !:PublicService.GetItemFieldValues for a list."
    },
    "itemAttributes": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "integer",
        "format": "int32"
      },
      "description": "Item attributes like: New, Used"
    },
    "shippingCondition": {
      "type": [
        "string",
        "null"
      ],
      "description": "Describes Shipping condition for this Item (500 chars)"
    },
    "paymentCondition": {
      "type": [
        "string",
        "null"
      ],
      "description": "Describes Payment condition for this Item (500 chars)"
    },
    "ownReferences": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "string"
      },
      "description": "The sellers own references for this Item (60 chars)."
    },
    "vat": {
      "type": [
        "integer",
        "null"
      ],
      "description": "VAT for the item. The VAT value can be retrieved from API method !:PublicService.GetItemFieldValues.",
      "format": "int32"
    },
    "itemImages": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "$ref": "#/$defs/ItemImageData"
      },
      "description": "Shop item images, an array of Tradera.Api.Services.Core.Contracts.Entities.ItemImageData objects (max 40 images).\r\nMax accepted size: 4MB"
    },
    "activateDate": {
      "type": [
        "string",
        "null"
      ],
      "description": "Date when Shop item will be active on Tradera.",
      "format": "date-time"
    },
    "deactivateDate": {
      "type": [
        "string",
        "null"
      ],
      "description": "Date when Shop item will be deactivated on Tradera.",
      "format": "date-time"
    },
    "quantity": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Modify the available quantity for this Item. This is a delta and will\r\nbe added to the current quantity. Use a negative value to decrease the\r\nquantity.",
      "format": "int32"
    },
    "absoluteQuantity": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Set the quantity to an absolute value, regardless of the current quantity.\r\nIt is not allowed to provide both AbsoluteQuantity and Quantity in the\r\nsame request.",
      "format": "int32"
    },
    "externalId": {
      "type": [
        "integer",
        "null"
      ],
      "description": "The id of the item in external system.",
      "format": "int32"
    },
    "price": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Shop item price.",
      "format": "int32"
    },
    "sellerPartNo": {
      "type": [
        "string",
        "null"
      ],
      "description": "Required id of the item in external system."
    },
    "variantData": {
      "$ref": "#/$defs/VariantData"
    },
    "attributeValues": {
      "$ref": "#/$defs/ItemAttributeValues"
    },
    "descriptionLanguageCodeIso2": {
      "type": [
        "string",
        "null"
      ],
      "description": "The description language code of the item."
    }
  },
  "additionalProperties": false,
  "$defs": {
    "ImageFormat": {
      "enum": [
        0,
        1,
        2
      ],
      "type": "integer",
      "description": "Specifies different image formats.",
      "format": "int32"
    },
    "ItemAttributeValues": {
      "type": "object",
      "properties": {
        "terms": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "$ref": "#/$defs/TermValues"
          }
        },
        "numbers": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "$ref": "#/$defs/NumberValues"
          }
        }
      },
      "additionalProperties": false
    },
    "ItemImageData": {
      "type": "object",
      "properties": {
        "hasMega": {
          "type": "boolean",
          "description": "If the Image should have a Mega image created when processed."
        },
        "format": {
          "$ref": "#/$defs/ImageFormat"
        },
        "data": {
          "type": [
            "string",
            "null"
          ],
          "description": "Image data (byte-array / base64 encoded).",
          "format": "byte"
        },
        "name": {
          "type": [
            "string",
            "null"
          ],
          "description": "Name of the image (optional)."
        }
      },
      "additionalProperties": false,
      "description": "Holds information for an item image."
    },
    "ItemShipping": {
      "type": "object",
      "properties": {
        "shippingOptionId": {
          "type": [
            "integer",
            "null"
          ],
          "description": "OBSOLETE: Use Tradera.Api.Services.Core.Contracts.Entities.ItemShipping.ShippingProviderId instead. Takes the same numeric ids.",
          "format": "int32"
        },
        "cost": {
          "type": "integer",
          "format": "int32"
        },
        "shippingWeight": {
          "type": [
            "number",
            "null"
          ],
          "format": "double"
        },
        "shippingWeightSpecified": {
          "type": "boolean"
        },
        "shippingProductId": {
          "type": [
            "integer",
            "null"
          ],
          "format": "int32"
        },
        "shippingProductIdSpecified": {
          "type": "boolean"
        },
        "shippingProviderId": {
          "type": [
            "integer",
            "null"
          ],
          "description": "The numeric id of the shipping provider. Call GetShippingOptions (SOAP) or\r\nGET /v4/reference-data/shipping-options (REST) for the providers a seller can use — every\r\nproduct returned carries the ShippingProviderId to send back. The set changes over time,\r\nso read it from the API rather than hard-coding it.\r\n            \r\nDEPRECATED providers, rejected when listing an item: Posten (1), Bussgods (3), UPS (4),\r\nFedEx (5), NotSpecified (10) and PostNordStampDenmark (15). Sellers who used Posten should\r\nuse PostNordParcel (12) or Alternative (6) instead.",
          "format": "int32"
        },
        "sellerSurcharge": {
          "type": [
            "integer",
            "null"
          ],
          "description": "Optional seller-defined surcharge added on top of the shipping product's base cost.\r\nNot yet used to compute the buyer-facing shipping price — Tradera.Api.Services.Core.Contracts.Entities.ItemShipping.Cost is still\r\nthe authoritative, required field today and must be sent. In a future API revision,\r\nTradera.Api.Services.Core.Contracts.Entities.ItemShipping.Cost will be removed and the buyer-facing price will be derived from\r\nthe shipping product (identified by Tradera.Api.Services.Core.Contracts.Entities.ItemShipping.ShippingProductId) adjusted by\r\nTradera.Api.Services.Core.Contracts.Entities.ItemShipping.SellerSurcharge and Tradera.Api.Services.Core.Contracts.Entities.ItemShipping.SellerDiscount.",
          "format": "int32"
        },
        "sellerSurchargeSpecified": {
          "type": "boolean"
        },
        "sellerDiscount": {
          "type": [
            "integer",
            "null"
          ],
          "description": "Optional seller-defined discount subtracted from the shipping product's base cost.\r\nNot yet used to compute the buyer-facing shipping price — Tradera.Api.Services.Core.Contracts.Entities.ItemShipping.Cost is still\r\nthe authoritative, required field today and must be sent. In a future API revision,\r\nTradera.Api.Services.Core.Contracts.Entities.ItemShipping.Cost will be removed and the buyer-facing price will be derived from\r\nthe shipping product (identified by Tradera.Api.Services.Core.Contracts.Entities.ItemShipping.ShippingProductId) adjusted by\r\nTradera.Api.Services.Core.Contracts.Entities.ItemShipping.SellerSurcharge and Tradera.Api.Services.Core.Contracts.Entities.ItemShipping.SellerDiscount.",
          "format": "int32"
        },
        "sellerDiscountSpecified": {
          "type": "boolean"
        }
      },
      "additionalProperties": false
    },
    "NumberValues": {
      "type": "object",
      "properties": {
        "id": {
          "type": "integer",
          "format": "int32"
        },
        "values": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": "number",
            "format": "double"
          }
        }
      },
      "additionalProperties": false
    },
    "TermValues": {
      "type": "object",
      "properties": {
        "id": {
          "type": "integer",
          "format": "int32"
        },
        "values": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": "string"
          }
        }
      },
      "additionalProperties": false
    },
    "VariantAttribute": {
      "type": "object",
      "properties": {
        "name": {
          "type": [
            "string",
            "null"
          ],
          "description": "Name of the attribute, e.g. Size"
        },
        "value": {
          "type": [
            "string",
            "null"
          ],
          "description": "Value of attribute, e.g. XXL"
        }
      },
      "additionalProperties": false,
      "description": "Shop item variant attribute."
    },
    "VariantData": {
      "type": "object",
      "properties": {
        "variantGroupId": {
          "type": [
            "string",
            "null"
          ],
          "description": "Id grouping all Items that are variants of each other."
        },
        "variantAttributes": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "$ref": "#/$defs/VariantAttribute"
          },
          "description": "Collection of variant attributes for the item."
        }
      },
      "additionalProperties": false,
      "description": "Shop item variant information."
    }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema 
curl "https://apis.io/api/v1/json-schemas/tradera-shop-item-variant-data"
All schemas 
curl "https://apis.io/api/v1/json-schemas?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.