File an adverse report
File a typed, severity-graded adverse report (illness / injury / allergic reaction / foreign object / spoilage / packaging defect) for the brand behind a scanned product. Requires an authenticated (social-auth) consumer. Returns a receipt carrying an immutable reference_id, the delivery record, and a prefilled handoff to the appropriate regulator — Closient files with nobody on your behalf, and never gives medical advice.
Rate-limited per identity and per IP (same tight feedback caps as signals). A banned identity is rejected with 403; an oversized body returns 422.
Authorizations
Body
Payload to file a new adverse report (consumer-facing).
GTIN of the product the report is about, from the resolution context.
Typed harm category (illness / injury / allergic_reaction / foreign_object / spoilage / packaging_defect).
illness, injury, allergic_reaction, foreign_object, spoilage, packaging_defect Optional consumer-declared severity (minor / moderate / serious / life_threatening). Omit or null if the consumer declined — Closient never infers it.
minor, moderate, serious, life_threatening Freeform description of what happened. May be empty for a voice-only report.
Batch/lot identifier (GS1 AI 10) from the scan. The lot is the correlation unit for alerts.
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).
22^[23456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$Explicit opt-in to be contacted by the brand about this report.
Contact address the consumer agrees to be reached at. Must be one of their own verified account email addresses. Only meaningful when contact_consent is true.
Response
Created
A filed adverse report as the reporter sees it — the receipt.
Carries the immutable reference id, the report's typed fields, the delivery record, and the prefilled regulator handoff (Closient never files on the consumer's behalf — the handoff is how they complete the real report).
Immutable, human-facing reference the reporter quotes to track it.
Public short-UUID identifier of the adverse report.
22^[23456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$GTIN-14 of the product this report is about.
Typed harm category code.
illness, injury, allergic_reaction, foreign_object, spoilage, packaging_defect Freeform description the consumer wrote (may be empty for voice-only).
Underlying signal lifecycle code: active or revoked.
True when a voice capture session backs this report.
Whether the consumer opted in to be contacted by the brand.
ISO-8601 timestamp the report was filed.
The immutable delivery record for this report.
Prefilled handoff to the appropriate regulator — the consumer completes the filing.
Batch/lot identifier (GS1 AI 10) from the scan, or null.
Serialized-unit context from the scan, or null.
Consumer-declared severity code, or null if not graded. Never inferred by Closient.
minor, moderate, serious, life_threatening