Skip to main content
POST
Check the brand domain's DNS TXT record

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

Result of checking the brand domain's TXT record for the claim token.

outcome
enum<string>
required

proof_recorded means the token matched and a domain-control proof was recorded for the reviewer. It does not change the claim's status.

Available options:
proof_recorded,
no_domain,
no_record,
token_mismatch,
lookup_error
message
string
required

What happened and, on a miss, what to fix.

record_name
string
required

TXT record name that was queried; empty if the brand has no domain.

token
string
required

The token the record must contain.

evidence
ClaimEvidenceOut · object | null
required

The recorded proof when outcome is proof_recorded.

Example:
claim_verification_status
enum<string>
required

The claim's status after the check, which a domain check never changes.

Available options:
unverified,
prefix_matched,
verified,
disputed,
rejected