GET Product Details
This endpoint returns a merged product record with the full size run and the EAN and UPC held for each size - one call when you need the shoe and every size code together. The style code is matched in upper case.
Set is_slug=1 when the path value is a marketplace slug instead of a style code; slug_store
is then required and must be alias or stockx. A slug request with another store answers 400.
Parameters
| Parameter | In | Required | Description |
|---|---|---|---|
style_code | path | yes | Manufacturer style code (SKU), for example DD1391-100. The value may contain slashes. A marketplace slug when is_slug is 1. |
is_slug | query | no | Treat the path value as a marketplace slug. |
slug_store | query | no | Marketplace the slug belongs to. Required when is_slug is 1; only alias and stockx are accepted. |
show_images | query | no | Send 1 to add goat_image, stockx_image and product_images. |
Billing behaviour
A successful call debits one request from the plan allowance. A call that finds nothing is fulfilled but not debited.
Route
/api/v2/product/details/{style_code}Ability
product-details
Response 200 (success)
{
"error": false,
"product": {
"sku": "string",
"type": "string",
"colourway": "string",
"category": "string",
"title": "string",
"brand": "string",
"nickname": "string",
"designer": "string",
"main_color": "string",
"model": "string",
"product_unique_id": "string|null",
"gender": "string",
"upper_material": "string",
"release_date": "YYYY-MM-DD|string",
"release_date_formatted": "DD/MM/YYYY|string",
"retail_price": "string|number|null",
"retail_price_gbp": "string|number|null",
"retail_price_usd": "string|number|null",
"description": "string",
"stockx_total_sold": "number|string|null",
"image": "url|string",
"sizes": [
{
"eu": "string",
"uk": "string",
"us": "string",
"ean": "string|null",
"upc": "string|null"
}
],
"variants": 1,
"variant_format": "UK|N/A|string",
"size_run": "string",
"internal_category": "Sneakers|Clothing|Accessories|Collectibles|string",
"search_sku": "string"
},
"response_time": "XXXms",
"request_fulfilled": true,
"request_debited": true
}Response 200 (not found)
{
"error": true,
"message": "No product could be found for this style code.",
"response_time": "XXXms",
"request_fulfilled": true,
"request_debited": false
}Response 403
{
"error": true,
"message": "API Token has run out of usage, please top up via the dashboard.",
"response_time": "XXXms",
"request_fulfilled": false,
"request_debited": false
}The barcode lookup API page shows the plans and examples.