Skip to main content
GET
Get a claim's verification status

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.

Pattern: ^[0-9]{8,14}$

Response

OK

Where a GTIN ownership claim stands and what would move it to Verified.

gtin
string
required

The product's GTIN-14.

claim_verification_status
enum<string>
required

Current verification tier. A claimed product with no status yet reads unverified.

Available options:
unverified,
prefix_matched,
verified,
disputed,
rejected
next_status
enum<string> | null
required

The tier this claim can climb to by self-serve evidence; null when verified, disputed or rejected.

Available options:
unverified,
prefix_matched,
verified,
disputed,
rejected
blocks_resolver_serving
boolean
required

True while the claim is not authoritative enough for the resolver to serve the brand's links.

checklist
ChecklistItemOut · object[]
required

Self-serve routes to Verified.

promotion_rules
PromotionRuleOut · object[]
required

Each evidence combination that qualifies for Verified and how far off it is. Any one rule suffices.

evidence
ClaimEvidenceOut · object[]
required

Evidence this organization has filed for the product, newest first.

domain_verification
DomainVerificationOut · object
required

Instructions for the domain-control checks.

Example: