Skip to main content
Version: V2

GET Demo Lookup

Public demo lookup route (no API token required).

Route​

/api/v2/demo/lookup

Middleware​

  • 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
}