GET Lookup Product by SKU

This endpoint returns every product variant stored under one manufacturer style code. Several products can share one style code: the response is a list, not a single record. Use the product_unique_id of a result with the lookup by unique ID endpoint when you need to address one variant.

Use this endpoint when you hold a style code such as DD1391-100 and need the product name, brand, category, colorway, release date, retail price or image URL. To start from a barcode instead, use the lookup by barcode endpoint.

Parameters

Parameter	In	Required	Description
`style_code`	path	yes	Manufacturer style code (SKU), for example `DD1391-100`. This route does not accept slashes in the value.
`show_data`	query	no	Send `1` to add the raw source payload (`product_data`) to each product.

Billing behaviour

A successful call debits one request from the plan allowance. A call that finds nothing is fulfilled but not debited, so a wrong style code costs nothing.

Route

/api/v2/product/lookup/sku/{style_code}

Ability

lookup-product

Response `200` (success)

{
    "error": false,
    "results": [
        {
            "product_last_checked": "datetime|null",
            "product_name": "string|null",
            "product_brand": "string|null",
            "product_category": "string|null",
            "product_unique_id": "string|null",
            "product_style_code": "string|null",
            "product_release_date": "YYYY-MM-DD|string|null",
            "product_description": "string|null",
            "product_colorway": "string|null",
            "product_retail_price": "string|number|null",
            "product_image": "https://.../api/image/uid/{product_unique_id}"
        }
    ],
    "response_time": "XXXms",
    "request_fulfilled": true,
    "request_debited": true
}

Response `200` (not found)

{
    "error": true,
    "message": "No product could be found for this search query.",
    "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.

On this page