Get brand adverse report
curl --request GET \
--url https://www.closient.com/signals/api/v1/brand/adverse-reports/{report_id}/ \
--header 'X-API-Key: <api-key>'import requests
url = "https://www.closient.com/signals/api/v1/brand/adverse-reports/{report_id}/"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://www.closient.com/signals/api/v1/brand/adverse-reports/{report_id}/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://www.closient.com/signals/api/v1/brand/adverse-reports/{report_id}/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://www.closient.com/signals/api/v1/brand/adverse-reports/{report_id}/"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://www.closient.com/signals/api/v1/brand/adverse-reports/{report_id}/")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://www.closient.com/signals/api/v1/brand/adverse-reports/{report_id}/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"batch": "LOT-2026-04",
"body": "Two of us were unwell a few hours after eating this.",
"consumer_region": "US-OR",
"contact_consent": true,
"contact_email": "shopper@example.com",
"created": "2026-07-14T14:30:00Z",
"delivery": {
"delivered_at": "2026-07-14T14:30:00Z",
"sla_deadline": "2026-07-15T14:30:00Z",
"state": "delivered",
"within_sla": true
},
"gtin": "00012345678905",
"has_voice": false,
"id": "a1b2c3d4e5f6",
"is_flagged": false,
"onset_date": "2026-07-13",
"onset_time": "19:30",
"reference_id": "AR-7F3K9Q2M",
"report_type": "illness",
"severity": "moderate"
}{
"detail": "The requested resource was not found.",
"error_code": "not_found",
"retryable": false,
"status": 404,
"timestamp": "2026-03-31T12:00:00+00:00",
"title": "Not Found",
"type": "https://closient.com/docs/errors/not_found"
}{
"detail": "The requested resource was not found.",
"error_code": "not_found",
"retryable": false,
"status": 404,
"timestamp": "2026-03-31T12:00:00+00:00",
"title": "Not Found",
"type": "https://closient.com/docs/errors/not_found"
}{
"detail": "The requested resource was not found.",
"error_code": "not_found",
"retryable": false,
"status": 404,
"timestamp": "2026-03-31T12:00:00+00:00",
"title": "Not Found",
"type": "https://closient.com/docs/errors/not_found"
}{
"detail": "The requested resource was not found.",
"error_code": "not_found",
"retryable": false,
"status": 404,
"timestamp": "2026-03-31T12:00:00+00:00",
"title": "Not Found",
"type": "https://closient.com/docs/errors/not_found"
}{
"detail": "The requested resource was not found.",
"error_code": "not_found",
"retryable": false,
"status": 404,
"timestamp": "2026-03-31T12:00:00+00:00",
"title": "Not Found",
"type": "https://closient.com/docs/errors/not_found"
}{
"detail": "The requested resource was not found.",
"error_code": "not_found",
"retryable": false,
"status": 404,
"timestamp": "2026-03-31T12:00:00+00:00",
"title": "Not Found",
"type": "https://closient.com/docs/errors/not_found"
}{
"detail": "The requested resource was not found.",
"error_code": "not_found",
"retryable": false,
"status": 404,
"timestamp": "2026-03-31T12:00:00+00:00",
"title": "Not Found",
"type": "https://closient.com/docs/errors/not_found"
}Adverse Reports
Get brand adverse report
Retrieve one adverse report for a product the authenticated brand member’s organization owns and has claimed. A report on an unowned or unclaimed product, or one that does not exist, reads as 404 (no existence oracle).
GET
/
signals
/
api
/
v1
/
brand
/
adverse-reports
/
{report_id}
/
Get brand adverse report
curl --request GET \
--url https://www.closient.com/signals/api/v1/brand/adverse-reports/{report_id}/ \
--header 'X-API-Key: <api-key>'import requests
url = "https://www.closient.com/signals/api/v1/brand/adverse-reports/{report_id}/"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://www.closient.com/signals/api/v1/brand/adverse-reports/{report_id}/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://www.closient.com/signals/api/v1/brand/adverse-reports/{report_id}/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://www.closient.com/signals/api/v1/brand/adverse-reports/{report_id}/"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://www.closient.com/signals/api/v1/brand/adverse-reports/{report_id}/")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://www.closient.com/signals/api/v1/brand/adverse-reports/{report_id}/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"batch": "LOT-2026-04",
"body": "Two of us were unwell a few hours after eating this.",
"consumer_region": "US-OR",
"contact_consent": true,
"contact_email": "shopper@example.com",
"created": "2026-07-14T14:30:00Z",
"delivery": {
"delivered_at": "2026-07-14T14:30:00Z",
"sla_deadline": "2026-07-15T14:30:00Z",
"state": "delivered",
"within_sla": true
},
"gtin": "00012345678905",
"has_voice": false,
"id": "a1b2c3d4e5f6",
"is_flagged": false,
"onset_date": "2026-07-13",
"onset_time": "19:30",
"reference_id": "AR-7F3K9Q2M",
"report_type": "illness",
"severity": "moderate"
}{
"detail": "The requested resource was not found.",
"error_code": "not_found",
"retryable": false,
"status": 404,
"timestamp": "2026-03-31T12:00:00+00:00",
"title": "Not Found",
"type": "https://closient.com/docs/errors/not_found"
}{
"detail": "The requested resource was not found.",
"error_code": "not_found",
"retryable": false,
"status": 404,
"timestamp": "2026-03-31T12:00:00+00:00",
"title": "Not Found",
"type": "https://closient.com/docs/errors/not_found"
}{
"detail": "The requested resource was not found.",
"error_code": "not_found",
"retryable": false,
"status": 404,
"timestamp": "2026-03-31T12:00:00+00:00",
"title": "Not Found",
"type": "https://closient.com/docs/errors/not_found"
}{
"detail": "The requested resource was not found.",
"error_code": "not_found",
"retryable": false,
"status": 404,
"timestamp": "2026-03-31T12:00:00+00:00",
"title": "Not Found",
"type": "https://closient.com/docs/errors/not_found"
}{
"detail": "The requested resource was not found.",
"error_code": "not_found",
"retryable": false,
"status": 404,
"timestamp": "2026-03-31T12:00:00+00:00",
"title": "Not Found",
"type": "https://closient.com/docs/errors/not_found"
}{
"detail": "The requested resource was not found.",
"error_code": "not_found",
"retryable": false,
"status": 404,
"timestamp": "2026-03-31T12:00:00+00:00",
"title": "Not Found",
"type": "https://closient.com/docs/errors/not_found"
}{
"detail": "The requested resource was not found.",
"error_code": "not_found",
"retryable": false,
"status": 404,
"timestamp": "2026-03-31T12:00:00+00:00",
"title": "Not Found",
"type": "https://closient.com/docs/errors/not_found"
}Authorizations
APIKeyHeaderAuthOAuthTokenAuthCookieGatedSessionAuth
Path Parameters
Public short-UUID id of the adverse report.
Required string length:
22Pattern:
^[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.
Public short-UUID identifier of the adverse report.
Required string length:
22Pattern:
^[23456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$The reporter's reference id — quote it in any correspondence.
GTIN-14 of the product this report is about.
Typed harm category code.
Available options:
illness, injury, allergic_reaction, foreign_object, spoilage, packaging_defect True when the declared severity (serious, hospitalization or life_threatening) meets the DSHEA / MoCRA definition of a serious adverse event, which starts the brand's reporting clock.
Business days the brand has to report to the regulator from receipt (15), or null if not serious.
Freeform description the consumer wrote (may be empty for voice-only).
True when a voice capture session backs this report.
Whether the consumer opted in to be contacted.
True when the text-hygiene heuristic flagged the body (advisory).
ISO-8601 timestamp the report was filed.
The immutable delivery record for this report.
Show child attributes
Show child attributes
Example:
{
"delivered_at": "2026-07-14T14:30:00Z",
"sla_deadline": "2026-07-15T14:30:00Z",
"state": "delivered",
"within_sla": true
}
Batch/lot identifier (GS1 AI 10), or null.
Serialized-unit context, or null.
Consumer-declared severity code, or null.
Available options:
minor, moderate, serious, hospitalization, life_threatening Consumer-declared state / province (ISO 3166-2, e.g. US-OR), or null when not declared. Never a precise location, never inferred from IP.
Available options:
US-AL, US-AK, US-AZ, US-AR, US-CA, US-CO, US-CT, US-DE, US-DC, US-FL, US-GA, US-HI, US-ID, US-IL, US-IN, US-IA, US-KS, US-KY, US-LA, US-ME, US-MD, US-MA, US-MI, US-MN, US-MS, US-MO, US-MT, US-NE, US-NV, US-NH, US-NJ, US-NM, US-NY, US-NC, US-ND, US-OH, US-OK, US-OR, US-PA, US-RI, US-SC, US-SD, US-TN, US-TX, US-UT, US-VT, US-VA, US-WA, US-WV, US-WI, US-WY, US-AS, US-GU, US-MP, US-PR, US-VI, CA-AB, CA-BC, CA-MB, CA-NB, CA-NL, CA-NS, CA-NT, CA-NU, CA-ON, CA-PE, CA-QC, CA-SK, CA-YT Consumer-declared date the harm began, or null when unknown.
Consumer-declared local time of day the harm began (no timezone), or null when unknown.
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.
Stable flag code, or null.
Available options:
profanity