Skip to main content
GET
Read product ingredient

Authorizations

X-API-Key
string
header
required

Path Parameters

gtin
string
required

GTIN barcode (8, 12, 13, or 14 digits, with or without separators). Normalized to GTIN-14 for lookup.

Minimum string length: 8
ingredient_id
string
required

UUID (or 22-char shortuuid) of the ingredient row.

Response

OK

An ingredient row sourced from the ProductSubstance join.

One row per substance linked to the product. Sorted by priority (which mirrors the order on the package label).

id
string<shortuuid>
required

Internal ProductSubstance identifier.

Required string length: 22
Pattern: ^[23456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$
name
string
required

Canonical substance name resolved from the linked Substance record.

is_major_allergen
boolean
required

True when the linked substance is on a recognized major-allergen list (e.g. FDA Big 9).

may_contain
boolean
required

True when the ingredient appears in a may contain cross-contamination disclosure rather than the primary ingredient list.

priority
integer
required

Position of the ingredient on the label (0 = first / most predominant by weight).

Required range: x >= 0
notes
string
required

Free-text annotation associated with this ingredient row. May be empty.

percentage
number | null

Percentage of total weight contributed by this ingredient, when disclosed on the label. Null when unspecified.

Required range: 0 <= x <= 100
origin
string
default:""

ISO 3166-1 alpha-2 country code identifying where the ingredient was sourced. Empty string when unknown.