Skip to main content
GET
Get brand adverse report

Authorizations

X-API-Key
string
header
required

Path Parameters

report_id
string<shortuuid>
required

Public short-UUID id of the adverse report.

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

Response

OK

An adverse report as a brand member sees it (ownership + claim scoped).

Same code-not-label contract. contact_email is present only under the consent + verification gate. Carries the lot context and the delivery record so the brand can see the report arrived inside SLA.

id
string<shortuuid>
required

Public short-UUID identifier of the adverse report.

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

The reporter's reference id — quote it in any correspondence.

gtin
string
required

GTIN-14 of the product this report is about.

report_type
enum<string>
required

Typed harm category code.

Available options:
illness,
injury,
allergic_reaction,
foreign_object,
spoilage,
packaging_defect
body
string
required

Freeform description the consumer wrote (may be empty for voice-only).

has_voice
boolean
required

True when a voice capture session backs this report.

Whether the consumer opted in to be contacted.

is_flagged
boolean
required

True when the text-hygiene heuristic flagged the body (advisory).

created
string<date-time>
required

ISO-8601 timestamp the report was filed.

delivery
DeliveryOut · object
required

The immutable delivery record for this report.

Example:
batch
string | null

Batch/lot identifier (GS1 AI 10), or null.

serial
string | null

Serialized-unit context, or null.

severity
enum<string> | null

Consumer-declared severity code, or null.

Available options:
minor,
moderate,
serious,
life_threatening
contact_email
string | null

The consumer's verified contact email — present ONLY when contact_consent is true AND a verified address is still attached. Null otherwise. Closient does not relay replies.

flag_reason
enum<string> | null

Stable flag code, or null.

Available options:
profanity