GET Lookup Barcodes by SKU

Reverse lookup: this endpoint returns the barcodes held for one style code, with the size each barcode identifies. Use it when you know the shoe (the style code) and need the codes: to print size-specific labels, to validate a scanned box against a size run, or to feed each size into the resale price endpoint.

By default the response paginates 20 barcodes per page. With sizerun=1 the response is one barcode per size for the whole size run, sorted by EU size, in a single page. That is the usual choice when you need every size once.

Parameters

Parameter	In	Required	Description
`style_code`	path	yes	Manufacturer style code (SKU), for example `DD1391-100`. The value may contain slashes.
`sizerun`	query	no	Return one barcode per size, preferring verified barcodes, without pagination.
`is_verified`	query	no	Leave out barcodes derived by the size-run algorithm. Ignored when `sizerun` is `true`.
`page`	query	no	Page number. Ignored when `sizerun` is `true`.

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/barcode/lookup/sku/{style_code}

Ability

lookup-barcode-sku

Query Parameters

sizerun (optional, boolean)
is_verified (optional, boolean; ignored when sizerun=true)

Response `200` (success)

{
    "error": false,
    "barcodes": [
        {
            "product_barcode_type": "string",
            "product_barcode_value": "string",
            "product_size": {
                "us": "string|number|null",
                "uk": "string|number|null",
                "eu": "string|number|null"
            },
            "isVerified": true
        }
    ],
    "pagination": {
        "current_page": "stringified integer",
        "next_page": "stringified integer|null",
        "has_next_page": true
    },
    "response_time": "XXXms",
    "request_fulfilled": true,
    "request_debited": true
}

Response `200` (no matches)

{
    "error": true,
    "message": "No barcodes could not 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.

On this page