Skip to main content
GET
Get my adverse report

Authorizations

X-API-Key
string
header
required

Path Parameters

reference_id
string
required

The report's reference id (e.g. AR-7F3K9Q2M).

Response

OK

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).

reference_id
string
required

Immutable, human-facing reference the reporter quotes to track it.

id
string<shortuuid>
required

Public short-UUID identifier of the adverse report.

Required string length: 22
Pattern: ^[23456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$
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).

status
string
required

Underlying signal lifecycle code: active or revoked.

has_voice
boolean
required

True when a voice capture session backs this report.

Whether the consumer opted in to be contacted by the brand.

created
string<date-time>
required

ISO-8601 timestamp the report was filed.

delivery
DeliveryOut · object
required

The immutable delivery record for this report.

Example:
regulator_handoff
RegulatorHandoffOut · object
required

Prefilled handoff to the appropriate regulator — the consumer completes the filing.

Example:
batch
string | null

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

serial
string | null

Serialized-unit context from the scan, or null.

severity
enum<string> | null

Consumer-declared severity code, or null if not graded. Never inferred by Closient.

Available options:
minor,
moderate,
serious,
life_threatening