DocsApi instructions
GET Demo Lookup
The public demo lookup route needs no API token. Send an 8 to 15 digit barcode and it answers with a limited product match, or a not-found result when the database holds nothing for it.
Use it to test an integration before the token arrives, or to show lookup behaviour without exposing a key. It carries no plan allowance and no size, image or price fields: those need a token on a plan. See the barcode lookup API page for the full endpoint and the plans.
Route
/api/v2/demo/lookupMiddleware
demo.throttle
Query Parameters
barcode(required, digits only, length 8-15)
Response 200 (found = false)
{
"error": false,
"found": false,
"barcode": "string",
"category": "sneaker",
"brand": null,
"model": null,
"colorway": null,
"releaseDate": null,
"retailPrice": null,
"images": [],
"sizes": [],
"confidence": null,
"demo": true,
"response_time": "XXXms",
"request_fulfilled": true,
"request_debited": false
}Response 200 (found = true)
{
"error": false,
"found": true,
"barcode": "string",
"barcode_type": "GTIN12|GTIN13|...",
"category": "string",
"style_code": "masked string",
"brand": "string|null",
"model": "masked string|null",
"colorway": "masked string|null",
"description": "masked string|null",
"releaseDate": "YYYY-MM-DD|null",
"retailPrice": "string|number|null",
"image": "hidden",
"sizes": [
"string or object depending on stored size format"
],
"sizesCount": 0,
"confidence": 0.99,
"demo": true,
"response_time": "XXXms",
"request_fulfilled": true,
"request_debited": false
}Response 400
{
"error": true,
"message": {
"barcode": [
"validation error messages"
]
},
"response_time": "XXXms",
"request_fulfilled": false,
"request_debited": false
}The barcode lookup API page shows the plans and examples.