Skip to main content
GET
/
certifications
/
api
/
v1
/
certifications
/
{id}
Get certification
curl --request GET \
  --url https://www.closient.com/certifications/api/v1/certifications/{id} \
  --header 'X-API-Key: <api-key>'
{
  "id": "<string>",
  "label": "<string>",
  "code": "",
  "description": "",
  "url": "",
  "logo_url": "<string>",
  "certification_body_name": "<string>",
  "program": "",
  "standard": ""
}

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 standardized certification definition (USDA Organic, Fair Trade, MSC, ...).

Mirrors :class:apps.certifications.models.Certification. Returned by both the list and detail endpoints. Distinct from a :class:CertificationAssignmentOut, which is the per-product instance of a certification (with certificate number, validity dates, etc.).

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

Public display name of the certification (e.g. USDA Organic).

Maximum string length: 255
​
code
string
default:""

Stable machine identifier for the certification (e.g. USDA_ORGANIC, FAIR_TRADE_USA). Empty for organization-private certifications that have not been assigned a code. Globally unique among non-org-scoped rows; unique per organization for org-scoped rows.

Maximum string length: 50
​
description
string
default:""

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

​
url
string
default:""

Canonical reference URL for the certification programme. Empty when not known. When present, always an absolute https:// URL.

​
logo_url
string | null

Absolute URL of the certification's stored logo. null when no logo has been uploaded. Sized variants (AVIF/WEBP at 100x100) are available server-side but not exposed here.

​
certification_body_name
string | null

Display name of the issuing :class:CertificationBody. null when the certification is not linked to a body record (e.g. brand-private certifications).

​
program
string
default:""

GS1 certificationAgency — the programme name (e.g. USDA National Organic Program). Empty when not specified. Surfaced in GS1 JSON-LD exports.

Maximum string length: 255
​
standard
string
default:""

Standard or regulation the certification is based on (e.g. 7 CFR Part 205). Empty when not specified. Surfaced in GS1 JSON-LD exports.

Maximum string length: 255