Cataref / product reference api
A reference layer for product identity
The same product arrives with different names, sizes and identifiers. Cataref separates the family, variant and trade item so your integration can work with the right level of detail.
Orange drink
مشروب برتقال
Bottle · 1 litre- Barcode / GTIN
- 9990000000012
- Product family
- Fruit drink
- Variant
- Orange
One reference connects the names, identifier and physical item. Example values are for demonstration.
Same product. Different physical units.
- 1Individual bottle1 litre · the trade itemBase unit
- 6Six packContains 6 individual bottles6 litres total
- 24Outer cartonContains 4 six packs24 litres total
Packaging relationships and content conversions stay explicit.
Language changes. Product identity stays.
- English en
- Orange drink
- العربية ar
- مشروب برتقال
Request a locale and inspect which language the response uses, including fallback when a requested name is unavailable.
Illustrative response fields
{
"display_name": {
"value": "Orange drink",
"locale": "en"
},
"package_type": "bottle",
"net_content": "1",
"content_unit": "L",
"identifiers": [
{
"scheme": "gtin",
"raw_value": "9990000000012"
}
]
}A response excerpt, not a live request. Open the developer guide for the full contract.
GET /v1/identifiers/lookupKnow which product you mean
Resolve exact GTINs and issuer identifiers. Keep variants and package quantities connected without flattening them into one record.
Keep the evidence with the fact
Contributions stay private until independent review. Accepted facts retain their source context, with rights controls and reviewed corrections.
Speak your catalogue’s language
Retrieve Arabic and English names and localized categories. Market and locale remain explicit in your requests.
See what each read costs
Estimate bounded requests, use scoped API keys, and track usage credits. Receipts distinguish a fresh read from an idempotent replay.
Updated:
Explore your workspace