Skip to main content
GET
Product compliance panel for the embeddable PIP widget

Path Parameters

gtin
string
required

Product barcode. GTIN-8, 12, 13 or 14, with or without separators — normalized to GTIN-14 server-side, so a retailer can pass whatever their PIM holds.

Response

OK

Everything the embeddable panel renders for one GTIN.

Which fields are populated depends on disclosure — read that first. An empty certifications on a full response means the product has none; on an unverified response it means Closient will not assert them. The two are different facts and the field alone cannot tell them apart, which is why disclosure is part of the contract rather than an implementation detail.

gtin
string
required

GTIN-14, zero-padded.

disclosure
enum<string>
required

How much of the record this response carries. full is the complete panel. suspended is the safety floor for a product whose owning organization is in its deletion grace window. unverified is the identity floor for a GTIN whose claim is not authoritative — recall status only, no name. age_restricted withholds detail that cannot be age-gated on a third-party page.

Available options:
full,
suspended,
unverified,
age_restricted
recall
EmbedRecallOut · object
required

Active-recall summary. Present at every disclosure level — a recall is regulator-issued rather than brand-supplied, so it is never withheld.

Examples:
pip_url
string
required

Canonical hosted product page for this GTIN.

name
string
default:""

Product name. Always empty on an unverified response.

brand_name
string
default:""

Brand name. Empty unless disclosure is full.

image_url
string
default:""

Product image URL. Empty when there is no usable image.

allergens
EmbedFactOut · object[]

Declared allergen traits.

certifications
EmbedFactOut · object[]

Assigned certifications.

ingredients
string
default:""

The printed ingredient label, verbatim.

allergen_warnings
string
default:""

'May contain' / cross-contamination warnings.

requires_age_verification
boolean
default:false

True when the full record is only available behind the hosted page's 18+ gate.

disclaimers
string[]

Legal disclaimer paragraphs required for this product's regulatory regime (e.g. DSCSA pharma). Empty for an unregulated product. When non-empty these must be displayed alongside the panel — they state what Closient is and is not for this product, and the hosted product page renders them for the same reason.