Skip to main content
GET
Get full product detail by GTIN

Authorizations

X-API-Key
string
header
required

Path Parameters

gtin
string
required

GTIN of the product to look up. Accepts GTIN-8, GTIN-12 (UPC-A), GTIN-13 (EAN-13), or GTIN-14; the service pads shorter forms to GTIN-14 internally before lookup.

Required string length: 8 - 14
Pattern: ^\d{8}$|^\d{12,14}$

Response

OK

Full product detail with substances, certifications, and claims.

Returned by GET /products/{gtin}. Heavier than :class:ProductOut — includes typed certification / claim / substance detail rather than label-only summaries, so an assistant can reason about validity, sources, and ingredient composition without a follow-up call.

gtin
string
required

GTIN-14 identifier (always 14 digits, zero-padded).

Required string length: 14
Pattern: ^\d{14}$
name
string
required

Product name.

brand
string
required

Brand name.

description
string
required

Product description. Empty string when not on file; never null.

image_url
string
required

Absolute HTTPS URL of the product image. Empty string when not on file.

category
string
required

Google Product Taxonomy full category path. Empty string when not assigned.

net_content
string
required

Net content with unit (e.g. '500ml', '340g'). Empty string when unknown.

country_of_origin
string
required

ISO 3166-1 alpha-2 country code (e.g. 'US', 'IT', 'JP'). Empty string when unknown.

certifications
CertificationDetailOut · object[]

Full certification details including validity, issuing body, and verification status. Empty list when no certifications are on file.

claims
ClaimDetailOut · object[]

Product claims with source and validity. Empty list when no claims are on file.

substances
SubstanceDetailOut · object[]

Substance composition with percentages and allergen flags, ordered by the underlying priority (declared order on the package). Empty list when no substance data is on file.