Skip to main content
POST
Submit claim evidence for review

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}$

Body

application/json

Evidence to file for staff review.

evidence_type
enum<string>
required

Kind of proof. Domain proofs are not accepted here: run the DNS or HTTP check and it records one.

Available options:
gs1_certificate,
gepir_lookup,
invoice,
other
notes
string
default:""

What the evidence shows. Required when no file is attached, as for a gepir_lookup whose registry record is described in text.

Maximum string length: 2000
file_base64
string | null

Base64-encoded file, optionally with a data: URI prefix. Must be a PDF, PNG, JPEG or WebP, judged by its bytes rather than its name. At most 1.5 MiB (1,572,864 bytes) decoded; a larger file is refused with 413.

filename
string
default:evidence

Original filename. It is not used to store the file, which is kept under a random name with the extension its content implies.

Maximum string length: 255

Response

Created

One piece of evidence the organization has filed for this claim.

id
string<shortuuid>
required

Evidence identifier.

Required string length: 22
Pattern: ^[23456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$
evidence_type
enum<string>
required

What kind of proof this is.

Available options:
gs1_certificate,
gepir_lookup,
domain_match,
dns_txt_proof,
invoice,
other,
staff_attestation
strength
enum<string>
required

How much it counts toward Verified, set from the evidence type.

Available options:
strong,
medium,
weak
review_status
enum<string>
required

Staff review state. Only approved, unexpired evidence counts toward Verified.

Available options:
pending,
approved,
rejected
badge
string
required

Display state combining review status and expiry: approved, rejected, expired or pending. An approved row past its expires_at reads expired and no longer counts.

notes
string
required

Free-text description submitted with the evidence.

has_file
boolean
required

Whether a file is attached. The file itself is visible only to reviewers.

expires_at
string<date-time> | null
required

When approved evidence stops counting toward Verified; null means it does not expire.

created
string<date-time>
required

When the evidence was submitted.