Check product data readiness
Evaluate product data completeness for a GTIN in the Closient product repository.
The service normalizes the input to GTIN-14, validates the GS1 check digit, and (if found) computes a weighted completeness score across seven product attributes (product name, brand, description, image, manufacturer, country of origin, net content). Returns the score, per-field breakdown, and actionable recommendations.
If an email is supplied with a valid GTIN, a ReadinessCheckLead is recorded for follow-up.
Authentication: none — anonymous access is allowed.
Rate limit: 10 requests per minute per source IP via the Ninja throttle, plus a 30-per-hour cache-backed limit per IP. Exceeding either yields 429 Too Many Requests with an RFC 9457 Problem Details body and a retry_after_seconds hint.
Validation failures (malformed GTIN, bad check digit) return HTTP 200 with valid: false and a populated error. Only infrastructural problems use error envelopes.
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.
Body
Request body for the readiness check.
GTIN to evaluate. Accepts GTIN-8, GTIN-12 (UPC-A), GTIN-13 (EAN-13), or GTIN-14 — digits only, no separators. The service normalizes to GTIN-14 before lookup. Returns valid: false with an error string if the value fails GS1 check-digit validation.
8 - 14^\d{8,14}$"00614141107346"
Optional contact email for lead capture. When supplied alongside a valid GTIN, a ReadinessCheckLead row is recorded for follow-up. Leave blank for an anonymous, no-trace check. Format is a standard local@domain.tld address; max 254 chars per RFC 5321.
254"alice@example.com"
Response
OK
Response body for the readiness check.
Always returns HTTP 200 with valid indicating whether the request
was acceptable. Validation failures (e.g. malformed GTIN) are reported
via valid: false plus error; other fields are empty/zero in
that case. Rate-limit and unexpected-server failures are reported via
standard RFC 9457 error envelopes (HTTP 429 / 500), not via this body.
True when the request was accepted and a readiness evaluation was produced. False when the GTIN failed format or check-digit validation; in that case only error is meaningful.
Human-readable validation error. Populated only when valid is false (e.g. "GTIN check digit is invalid"); empty otherwise.
Input GTIN normalized to a 14-digit string (zero-padded GTIN-8/12/13 included). Populated when valid is true; empty otherwise.
^\d{14}$|^$Outcome bucket for the readiness check. ready when score ≥ 70 and the GTIN is in the repository; partial when the GTIN is in the repository but score < 70; not_found when the GTIN is not in the Closient product repository. null when valid is false.
ready, partial, not_found Weighted completeness percentage (0–100). Sum of weight for populated fields divided by sum of weight over all scored fields. Zero when valid is false or when the GTIN is not in the repository.
0 <= x <= 100Brand display name from the Closient product repository. Populated when internal_found is true and the product has a brand assigned; empty otherwise.
Product display name from the Closient product repository. Populated when internal_found is true and the product has a name; empty otherwise.
True when the GTIN exists in the Closient product repository, false when it does not. Equivalent to status != 'not_found' for valid responses.
Per-field completeness breakdown for every attribute the scorer inspects. Always present for valid responses (entries report populated: false for products not in the repository); empty when valid is false.
Ordered, human-readable suggestions for improving the score. When internal_found is false, contains a single message asking the brand to add the GTIN; otherwise contains one message per missing field.