# Get detailed information about multiple products.

Retrieves detailed information about multiple products. This contains the name, brand, images, the current stock count and much more.

Endpoint: POST /baskets/products/details
Version: 2025-09-15
Security: Basket-API-Endpoints

## Query parameters:

  - `provider_id` (string)
    Optional provider identifier to use as a fallback when tracking session is unavailable or does not contain provider information. This ensures tracking events can still be attributed to the correct provider.
    Example: "netflix"

## Header parameters:

  - `X-API-Key` (string, required)
    API access key for authorized use of the checkout endpoints. Partners, please contact Transfermedia to retrieve a valid key.

  - `X-JAY-Tracking` (string)
    Tracking session header for user tracking and analytics. This is set by the /playouts/tracking/session endpoint.
    Example: "eyJzZXNzaW9uX2lkIjoiZXhhbXBsZS1zZXNzaW9uLWlkLTEyMzQiLCJzdGFydF90aW1lIjoiMjAyNS0wMS0wMVQxMjowMDowMC4wMDAwMDAiLCJzb3VyY2UiOiJqYXkuYXBpLnBsYXlvdXQuZXhhbXBsZSJ9"

  - `x-jay-api-version` (string)
    The version of the API to use. Defaults to 2025-09-15.

## Response 200 fields (application/json):

  - `data` (object)
    The response data.
    Example: {"products":["item"]}

  - `data.products` (array)
    Example: ["item"]

  - `data.products.currentStockCount` (integer)
    The number of products available in the shop. Negative if not available anymore. None if available without limit.

  - `data.products.productId` (string)
    The product identifier.

  - `data.products.count` (integer)
    The number of products to order. Default is 1. A value above zero place the product in the cart. A value equal to zero places the product in the saved list.

  - `data.products.variant` (string)
    The product variant (e.g. the size). If empty the main product is addressed.

  - `data.products.mainProductIdentifier` (string)
    The identifier of this main product.

  - `data.products.shopSource` (string)
    The shop source the object is stored under.

  - `data.products.slug` (string)
    The slug name. A slug is a URL-friendly version of a string, typically used in URLs to identify a resource in a human-readable way. Slugs use only lowercase letters, numbers and hyphens. To remove the slug assign an empty string.

  - `data.products.url` (string)
    A link to an external resource.

  - `data.products.urlLabel` (string)
    The link label

  - `data.products.urlNote` (string)
    The link note

  - `data.products.urlImageId` (string)
    The link image id (or url/upload_key/download_url/data_identifier) of the associated image.

  - `data.products.urlImage` (object)
    The link image object.

  - `data.products.urlImage.id` (string)
    The identifier of this object.

  - `data.products.urlImage.url` (string)
    The url/upload_key/download_url/data_identifier of the associated image.

  - `data.products.urlImage.copyrightText` (string)
    The copyright text for the image.

  - `data.products.urlImage.mlInstanceId` (integer)
    Stores the associated ActorInstance/CostumeInstance identifier the image is linked to. This field is ignored in the project object.

  - `data.products.linkIds` (array)
    The link.

  - `data.products.groupIds` (array)
    The ids of the associated groups.

  - `data.products.currency` (string)
    The price's currency.

  - `data.products.price` (string)
    The price (including discount).

  - `data.products.priceInt` (integer)
    The price (including discount) given in minor units (e.g. 2799 for 27,99 EUR).

  - `data.products.originalPrice` (string)
    The original price (without discount).

  - `data.products.originalPriceInt` (integer)
    The original price (without discount) given in minor units (e.g. 3599 for 35,99 EUR).

  - `data.products.tenantObjectId` (string)
    The identifier of the associated tenant-wide template object. This field is designed to relate this object in a project to an tenant-wide object. This field is ignored for a tenant-wide object.

  - `data.products.name` (string)
    The mandatory name.

  - `data.products.subLine` (string)
    A sub line text.

  - `data.products.description` (string)
    A descriptive text.

  - `data.products.sku` (string)
    The stock keeping unit (article number).

  - `data.products.brand` (string)
    The brand (e.g. "Steffen Klein")

  - `data.products.gender` (string)
    The gender (usually starting with m/w/d).

  - `data.products.material` (string)
    The material (e.g. "100% linen").

  - `data.products.colour` (string)
    The colour (e.g. "red").

  - `data.products.colourCode` (string)
    The colour code as RGB value.

  - `data.products.size` (string)
    The available sizes (e.g. "S:Small,M:Medium,L:Large,XL:Extra-Large").

  - `data.products.country` (string)
    The country.

  - `data.products.imageIds` (array)
    The ids (or urls/upload_keys/download_urls/data_identifiers) of the associated images.

  - `data.products.images` (array)
    The image objects.

  - `data.products.artefactType` (string)
    The generic term of the artefact.

  - `data.products.notShoppable` (boolean)
    If True the product is not shoppable (e.g. Restaurant, Recipe, ...).

  - `data.products.fit` (string)
    The fit of the costume

  - `data.products.sizeIds` (array)
    The ids of the associated sizes.

  - `data.products.imagesLogoId` (string)
    The ids (or urls/upload_keys/download_urls/data_identifiers) of the associated images.

  - `data.products.imagesLogo` (object)
    The image objects logo.

  - `data.products.availability` (string)
    The product availability (e.g. "AVAILABLE", "OUT_OF_STOCK")

  - `data.products.sizes` (array)
    The product variants (e.g. sizes).

  - `data.products.sizes.availability` (string)
    The product availability (e.g. "AVAILABLE", "OUT_OF_STOCK", "MANY", "LOW")

  - `data.products.sizes.short` (string)
    The short value of the size (e.g. "S", "M", "56", "55,5").

  - `data.products.sizes.long` (string)
    The long value of the size (e.g. "Small", "Medium"). If not available use short value.

  - `data.products.outOfStock` (boolean)
    If True the product is out_of_stock

  - `nextToken` (string)
    The token, which can be used to retrieve the next page of data.

  - `error` (object)
    Details of the error that occurred during the API request, including error code and message. This field is only present when the request results in an error.

  - `error.code` (integer, required)
    The API error code
    Enum: 1001, 1002, 1003, 1004, 1005, 1006, 1007, 1008, 1009, 1010, 1011, 1012, 1013, 1014, 2001, 2002, 2003, 2004, 2005, 2006, 2008, 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019, 2020, 2021, 2022, 2023, 2024, 2025, 3000, 3001, 3002, 3003, 3004, 3005, 3006, 3007, 4001, 4002, 5001, 5002, 5003, 5004, 200, 201, 202, 204, 400, 401, 403, 404, 405, 406, 422, 423, 501, 503

  - `error.message` (string, required)
    The API error message.

  - `error.details` (any)
    The HTTP error details.

## Response 401 fields (application/json):

  - `data` (object)
    The response data.
    Example: {"products":["item"]}

  - `data.products` (array)
    Example: ["item"]

  - `data.products.currentStockCount` (integer)
    The number of products available in the shop. Negative if not available anymore. None if available without limit.

  - `data.products.productId` (string)
    The product identifier.

  - `data.products.count` (integer)
    The number of products to order. Default is 1. A value above zero place the product in the cart. A value equal to zero places the product in the saved list.

  - `data.products.variant` (string)
    The product variant (e.g. the size). If empty the main product is addressed.

  - `data.products.mainProductIdentifier` (string)
    The identifier of this main product.

  - `data.products.shopSource` (string)
    The shop source the object is stored under.

  - `data.products.slug` (string)
    The slug name. A slug is a URL-friendly version of a string, typically used in URLs to identify a resource in a human-readable way. Slugs use only lowercase letters, numbers and hyphens. To remove the slug assign an empty string.

  - `data.products.url` (string)
    A link to an external resource.

  - `data.products.urlLabel` (string)
    The link label

  - `data.products.urlNote` (string)
    The link note

  - `data.products.urlImageId` (string)
    The link image id (or url/upload_key/download_url/data_identifier) of the associated image.

  - `data.products.urlImage` (object)
    The link image object.

  - `data.products.urlImage.id` (string)
    The identifier of this object.

  - `data.products.urlImage.url` (string)
    The url/upload_key/download_url/data_identifier of the associated image.

  - `data.products.urlImage.copyrightText` (string)
    The copyright text for the image.

  - `data.products.urlImage.mlInstanceId` (integer)
    Stores the associated ActorInstance/CostumeInstance identifier the image is linked to. This field is ignored in the project object.

  - `data.products.linkIds` (array)
    The link.

  - `data.products.groupIds` (array)
    The ids of the associated groups.

  - `data.products.currency` (string)
    The price's currency.

  - `data.products.price` (string)
    The price (including discount).

  - `data.products.priceInt` (integer)
    The price (including discount) given in minor units (e.g. 2799 for 27,99 EUR).

  - `data.products.originalPrice` (string)
    The original price (without discount).

  - `data.products.originalPriceInt` (integer)
    The original price (without discount) given in minor units (e.g. 3599 for 35,99 EUR).

  - `data.products.tenantObjectId` (string)
    The identifier of the associated tenant-wide template object. This field is designed to relate this object in a project to an tenant-wide object. This field is ignored for a tenant-wide object.

  - `data.products.name` (string)
    The mandatory name.

  - `data.products.subLine` (string)
    A sub line text.

  - `data.products.description` (string)
    A descriptive text.

  - `data.products.sku` (string)
    The stock keeping unit (article number).

  - `data.products.brand` (string)
    The brand (e.g. "Steffen Klein")

  - `data.products.gender` (string)
    The gender (usually starting with m/w/d).

  - `data.products.material` (string)
    The material (e.g. "100% linen").

  - `data.products.colour` (string)
    The colour (e.g. "red").

  - `data.products.colourCode` (string)
    The colour code as RGB value.

  - `data.products.size` (string)
    The available sizes (e.g. "S:Small,M:Medium,L:Large,XL:Extra-Large").

  - `data.products.country` (string)
    The country.

  - `data.products.imageIds` (array)
    The ids (or urls/upload_keys/download_urls/data_identifiers) of the associated images.

  - `data.products.images` (array)
    The image objects.

  - `data.products.artefactType` (string)
    The generic term of the artefact.

  - `data.products.notShoppable` (boolean)
    If True the product is not shoppable (e.g. Restaurant, Recipe, ...).

  - `data.products.fit` (string)
    The fit of the costume

  - `data.products.sizeIds` (array)
    The ids of the associated sizes.

  - `data.products.imagesLogoId` (string)
    The ids (or urls/upload_keys/download_urls/data_identifiers) of the associated images.

  - `data.products.imagesLogo` (object)
    The image objects logo.

  - `data.products.availability` (string)
    The product availability (e.g. "AVAILABLE", "OUT_OF_STOCK")

  - `data.products.sizes` (array)
    The product variants (e.g. sizes).

  - `data.products.sizes.availability` (string)
    The product availability (e.g. "AVAILABLE", "OUT_OF_STOCK", "MANY", "LOW")

  - `data.products.sizes.short` (string)
    The short value of the size (e.g. "S", "M", "56", "55,5").

  - `data.products.sizes.long` (string)
    The long value of the size (e.g. "Small", "Medium"). If not available use short value.

  - `data.products.outOfStock` (boolean)
    If True the product is out_of_stock

  - `nextToken` (string)
    The token, which can be used to retrieve the next page of data.

  - `error` (object)
    Details of the error that occurred during the API request, including error code and message. This field is only present when the request results in an error.

  - `error.code` (integer, required)
    The API error code
    Enum: 1001, 1002, 1003, 1004, 1005, 1006, 1007, 1008, 1009, 1010, 1011, 1012, 1013, 1014, 2001, 2002, 2003, 2004, 2005, 2006, 2008, 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019, 2020, 2021, 2022, 2023, 2024, 2025, 3000, 3001, 3002, 3003, 3004, 3005, 3006, 3007, 4001, 4002, 5001, 5002, 5003, 5004, 200, 201, 202, 204, 400, 401, 403, 404, 405, 406, 422, 423, 501, 503

  - `error.message` (string, required)
    The API error message.

  - `error.details` (any)
    The HTTP error details.

## Response 422 fields (application/json):

  - `data` (object)
    The response data.
    Example: {"products":["item"]}

  - `data.products` (array)
    Example: ["item"]

  - `data.products.currentStockCount` (integer)
    The number of products available in the shop. Negative if not available anymore. None if available without limit.

  - `data.products.productId` (string)
    The product identifier.

  - `data.products.count` (integer)
    The number of products to order. Default is 1. A value above zero place the product in the cart. A value equal to zero places the product in the saved list.

  - `data.products.variant` (string)
    The product variant (e.g. the size). If empty the main product is addressed.

  - `data.products.mainProductIdentifier` (string)
    The identifier of this main product.

  - `data.products.shopSource` (string)
    The shop source the object is stored under.

  - `data.products.slug` (string)
    The slug name. A slug is a URL-friendly version of a string, typically used in URLs to identify a resource in a human-readable way. Slugs use only lowercase letters, numbers and hyphens. To remove the slug assign an empty string.

  - `data.products.url` (string)
    A link to an external resource.

  - `data.products.urlLabel` (string)
    The link label

  - `data.products.urlNote` (string)
    The link note

  - `data.products.urlImageId` (string)
    The link image id (or url/upload_key/download_url/data_identifier) of the associated image.

  - `data.products.urlImage` (object)
    The link image object.

  - `data.products.urlImage.id` (string)
    The identifier of this object.

  - `data.products.urlImage.url` (string)
    The url/upload_key/download_url/data_identifier of the associated image.

  - `data.products.urlImage.copyrightText` (string)
    The copyright text for the image.

  - `data.products.urlImage.mlInstanceId` (integer)
    Stores the associated ActorInstance/CostumeInstance identifier the image is linked to. This field is ignored in the project object.

  - `data.products.linkIds` (array)
    The link.

  - `data.products.groupIds` (array)
    The ids of the associated groups.

  - `data.products.currency` (string)
    The price's currency.

  - `data.products.price` (string)
    The price (including discount).

  - `data.products.priceInt` (integer)
    The price (including discount) given in minor units (e.g. 2799 for 27,99 EUR).

  - `data.products.originalPrice` (string)
    The original price (without discount).

  - `data.products.originalPriceInt` (integer)
    The original price (without discount) given in minor units (e.g. 3599 for 35,99 EUR).

  - `data.products.tenantObjectId` (string)
    The identifier of the associated tenant-wide template object. This field is designed to relate this object in a project to an tenant-wide object. This field is ignored for a tenant-wide object.

  - `data.products.name` (string)
    The mandatory name.

  - `data.products.subLine` (string)
    A sub line text.

  - `data.products.description` (string)
    A descriptive text.

  - `data.products.sku` (string)
    The stock keeping unit (article number).

  - `data.products.brand` (string)
    The brand (e.g. "Steffen Klein")

  - `data.products.gender` (string)
    The gender (usually starting with m/w/d).

  - `data.products.material` (string)
    The material (e.g. "100% linen").

  - `data.products.colour` (string)
    The colour (e.g. "red").

  - `data.products.colourCode` (string)
    The colour code as RGB value.

  - `data.products.size` (string)
    The available sizes (e.g. "S:Small,M:Medium,L:Large,XL:Extra-Large").

  - `data.products.country` (string)
    The country.

  - `data.products.imageIds` (array)
    The ids (or urls/upload_keys/download_urls/data_identifiers) of the associated images.

  - `data.products.images` (array)
    The image objects.

  - `data.products.artefactType` (string)
    The generic term of the artefact.

  - `data.products.notShoppable` (boolean)
    If True the product is not shoppable (e.g. Restaurant, Recipe, ...).

  - `data.products.fit` (string)
    The fit of the costume

  - `data.products.sizeIds` (array)
    The ids of the associated sizes.

  - `data.products.imagesLogoId` (string)
    The ids (or urls/upload_keys/download_urls/data_identifiers) of the associated images.

  - `data.products.imagesLogo` (object)
    The image objects logo.

  - `data.products.availability` (string)
    The product availability (e.g. "AVAILABLE", "OUT_OF_STOCK")

  - `data.products.sizes` (array)
    The product variants (e.g. sizes).

  - `data.products.sizes.availability` (string)
    The product availability (e.g. "AVAILABLE", "OUT_OF_STOCK", "MANY", "LOW")

  - `data.products.sizes.short` (string)
    The short value of the size (e.g. "S", "M", "56", "55,5").

  - `data.products.sizes.long` (string)
    The long value of the size (e.g. "Small", "Medium"). If not available use short value.

  - `data.products.outOfStock` (boolean)
    If True the product is out_of_stock

  - `nextToken` (string)
    The token, which can be used to retrieve the next page of data.

  - `error` (object)
    Details of the error that occurred during the API request, including error code and message. This field is only present when the request results in an error.

  - `error.code` (integer, required)
    The API error code
    Enum: 1001, 1002, 1003, 1004, 1005, 1006, 1007, 1008, 1009, 1010, 1011, 1012, 1013, 1014, 2001, 2002, 2003, 2004, 2005, 2006, 2008, 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019, 2020, 2021, 2022, 2023, 2024, 2025, 3000, 3001, 3002, 3003, 3004, 3005, 3006, 3007, 4001, 4002, 5001, 5002, 5003, 5004, 200, 201, 202, 204, 400, 401, 403, 404, 405, 406, 422, 423, 501, 503

  - `error.message` (string, required)
    The API error message.

  - `error.details` (any)
    The HTTP error details.