Skip to main content
POST
/
products
/
api
/
v1
/
products
/
{gtin}
/
report-claim
Report a suspicious GTIN ownership claim
curl --request POST \
  --url https://www.closient.com/products/api/v1/products/{gtin}/report-claim \
  --header 'Content-Type: application/json' \
  --data '
{
  "reporter_email": "<string>",
  "reason": "<string>",
  "reporter_phone": "",
  "reporter_company": "",
  "supporting_url": ""
}
'
{
  "id": "<string>",
  "gtin": "<string>",
  "message": "<string>"
}

Path Parameters

​
gtin
string
required

GTIN barcode (8, 12, 13, or 14 digits, with or without separators). Normalized to GTIN-14 for lookup.

Body

application/json

Body for POST /products/{gtin}/report-claim.

Reporters do not need a Closient account — real brand owners often discover their GTIN was squatted before they sign up. Required fields are the contact email, the relationship to the product, and a free-text reason; optional fields offer corroborating context.

​
reporter_email
string
required

Contact email used by Closient staff for follow-up. Not shown to the current claimant.

Maximum string length: 254
​
reporter_relationship
enum<string>
required

How the reporter relates to the brand or product. Used to weigh the report alongside the report count from distinct IPs; not a verdict.

Available options:
brand_rep,
legal,
consumer,
competitor,
staff,
other
​
reason
string
required

Free-text explanation of why the current claim is suspicious. Reviewed by Closient staff.

Required string length: 10 - 5000
​
reporter_phone
string
default:""

Optional phone number for follow-up. Not shown to the current claimant.

Maximum string length: 32
​
reporter_company
string
default:""

Optional company affiliation of the reporter (e.g. brand name, law firm).

Maximum string length: 255
​
supporting_url
string
default:""

Optional URL providing corroborating evidence (e.g. a brand-site product page that proves ownership).

Maximum string length: 2000

Response

Created

Acknowledgement returned after a claim report is filed.

​
id
string
required

Internal report identifier — quote this when contacting Closient about the report.

​
gtin
string
required

Normalized GTIN-14 the report was filed against.

Required string length: 14
Pattern: ^\d{14}$
​
status
enum<string>
required

Lifecycle status of the report. Always pending on creation; transitions to acknowledged, actioned, or dismissed only by Closient admin action.

Available options:
pending,
acknowledged,
actioned,
dismissed
​
message
string
required

Human-readable acknowledgement suitable for surfacing in a UI toast.