Skip to main content
GET
/
certifications
/
api
/
v1
/
claims
/
{id}
Get claim
curl --request GET \
  --url https://www.closient.com/certifications/api/v1/claims/{id} \
  --header 'X-API-Key: <api-key>'
{
  "id": "<string>",
  "code": "<string>",
  "label": "<string>",
  "category": "DIETARY",
  "requires_definition": true,
  "description": ""
}

Documentation Index

Fetch the complete documentation index at: https://docs.closient.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
X-API-Key
string
header
required

Path Parameters

​
id
string<shortuuid>
required

URL-safe 22-character shortuuid encoding of the row's UUID. Preferred over the raw UUID id for human-shareable URLs and log lines.

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

Response

OK

A brand claim definition (Non-GMO, Vegan, Gluten-Free, ...).

Mirrors :class:apps.certifications.models.Claim. Distinct from a :class:ClaimAssignmentOut, which is the per-product instance of a claim (with source, validity, and evidence URL).

​
id
string<shortuuid>
required

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}$
​
code
string
required

Stable machine identifier for the claim (e.g. NON_GMO, VEGAN). Globally unique.

Maximum string length: 50
​
label
string
required

Public display name of the claim (e.g. Non-GMO).

Maximum string length: 100
​
category
enum<string>
required

High-level grouping for filtering and presentation. DIETARY for dietary preferences (vegan, kosher); INGREDIENT_ABSENCE for without-X claims (no high-fructose corn syrup); ALLERGEN_FREE for explicit allergen-free assertions; PROCESS for process-based claims (grass-fed, cold-pressed); SUSTAINABILITY for environmental claims; OTHER for the long tail.

Available options:
DIETARY,
INGREDIENT_ABSENCE,
ALLERGEN_FREE,
PROCESS,
SUSTAINABILITY,
OTHER
​
requires_definition
boolean
required

When true, the claim requires the brand to provide a textual definition (or the claim is meaningful only with one). Used by front-end forms to gate evidence collection.

​
description
string
default:""

Free-text summary of what the claim means. May be empty.