Quickstart

1. Create an Account

Sign up at closient.com/accounts/signup to create your free account. You’ll land in your Dashboard where you can create an organization and generate API keys.

2. Generate an API Key

Navigate to Settings > API Keys in your Dashboard and create a new key. Keys follow the format:

<prefix>_<body>_<checksum>

Prefix	Type	Use Case
`csb`	Business	Server-side API access (full permissions)
`csu`	User	User-scoped API access
`cpk`	Publishable	Client-side embeds and widgets (rate-limited, org-scoped)

The body is 32 random characters and the checksum is a CRC-32 hex digest for format validation.

API keys are shown once at creation time. They’re stored as SHA-256 hashes and cannot be retrieved — only revoked and replaced.

3. Look Up a Product by GTIN

curl -H "X-API-Key: YOUR_API_KEY" \
  https://www.closient.com/products/api/v1/products?gtin=00012345678905

import requests

response = requests.get(
    "https://www.closient.com/products/api/v1/products",
    params={"gtin": "00012345678905"},
    headers={"X-API-Key": "YOUR_API_KEY"},
)
product = response.json()

GTINs are always normalized to GTIN-14 (zero-padded). You can pass GTIN-8, GTIN-12 (UPC-A), GTIN-13 (EAN), or GTIN-14 — the API handles normalization.

4. Resolve a GS1 Digital Link

Any GTIN can be resolved via a GS1 Digital Link URI:

curl -H "Accept: application/json" \
  https://www.closient.com/01/00012345678905

curl -H "Accept: application/linkset+json" \
  https://www.closient.com/01/00012345678905

curl -H "Accept: application/json" \
  https://www.closient.com/01/00012345678905/10/BATCH123/21/SERIAL001

5. Understand the Response Envelope

All list endpoints return paginated results:

{
  "data": [
    {
      "id": "ack3p9tw6x7r",
      "gtin": "00012345678905",
      "product_name": "Example Product",
      "brand": "Example Brand",
      "data_source": "claimed",
      "confidence_score": 0.95
    }
  ],
  "pagination": {
    "page": 1,
    "page_size": 25,
    "total_count": 1,
    "total_pages": 1,
    "has_next": false,
    "has_previous": false
  }
}

Next Steps

Authentication

API key types, RBAC roles, and security best practices.

Digital Link Resolution

Configure resolution rules, scope hierarchy, and time-based routing.

EPCIS 2.0

Capture supply chain events with full vocabulary support.

API Reference

Browse all 18 APIs with interactive playgrounds.

Getting Started

Developer Questions

User Guides

Technical Guides

MCP Server

Agent Skills

Compliance

Concepts

API Reference

Resources

1. Create an Account

2. Generate an API Key

3. Look Up a Product by GTIN

4. Resolve a GS1 Digital Link

5. Understand the Response Envelope

Next Steps

Authentication

Digital Link Resolution

EPCIS 2.0

API Reference

​1. Create an Account

​2. Generate an API Key

​3. Look Up a Product by GTIN

​4. Resolve a GS1 Digital Link

​5. Understand the Response Envelope

​Next Steps

Authentication

Digital Link Resolution

EPCIS 2.0

API Reference

1. Create an Account

2. Generate an API Key

3. Look Up a Product by GTIN

4. Resolve a GS1 Digital Link

5. Understand the Response Envelope

Next Steps