Skip to main content
POST
/
products
/
api
/
v1
/
products
/
{gtin}
/
claim
Claim a product
curl --request POST \
  --url https://www.closient.com/products/api/v1/products/{gtin}/claim \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "organization_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}
'
{
  "gtin": "<string>",
  "owner_id": "<string>",
  "claimed_at": "<string>",
  "message": "<string>"
}

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.

Body

application/json

Optional body sent with claim/unclaim/delete requests.

​
organization_id
string<shortuuid> | null

URL-safe 22-character shortuuid encoding of the row's UUID primary key. Stable across the row's lifetime; suitable for sharing in URLs, log lines, and external SDK clients. Accepted on input as either the shortuuid form or the canonical UUID form (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx).

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

Response

OK

Receipt returned after a successful GTIN claim.

​
gtin
string
required

Normalized GTIN-14 (zero-padded). Stable across the catalog regardless of input format.

Required string length: 14
Pattern: ^\d{14}$
​
owner_id
string<shortuuid>
required

Identifier of the Organization that now owns the claim.

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

ISO 8601 timestamp of when the claim was recorded. Reflects the resolver-enabled timestamp when the product was already enrolled, otherwise the time the claim API processed the request.

​
claim_verification_status
enum<string>
required

Verification tier assigned to the new claim. Always unverified initially; upgraded asynchronously by external verification (GS1 prefix lookup, GEPIR, etc.).

Available options:
unverified,
prefix_matched,
verified,
disputed,
rejected
​
message
string
required

Human-readable confirmation suitable for surfacing in a UI toast.