Prohibited Goods Screening

POST/v1/compliance/prohibited-goods$0.05 per call

Screen commodities for import/export prohibitions and restrictions by country.

Send an Idempotency-Key header to retry safely.

Request body

Field	Type	Description
originCountryrequired	string	ISO-2/3 origin country min length 2 · max length 3
destinationCountryrequired	string	ISO-2/3 destination country min length 2 · max length 3
commodityDescriptionrequired	string	max length 2000
hsCodeoptional	string	Optional HS code for more precise screening

Response fields

Field	Type	Description
success	boolean	e.g. `true`
data	object
data.id	string	e.g. `pg_a61c91052ffd592f`
data.originCountry	string	e.g. `US`
data.destinationCountry	string	e.g. `CN`
data.commodityDescription	string	e.g. `Industrial machine tools`
data.hsCode	null
data.evaluation	object
data.evaluation.isProhibited	boolean	e.g. `false`
data.evaluation.isRestricted	boolean	e.g. `false`
data.evaluation.riskLevel	string	e.g. `LOW`
data.evaluation.prohibitions	array
data.evaluation.restrictions	array
data.evaluation.warnings	array
data.regulatoryReferences	array
data.evaluatedAt	string	e.g. `2026-11-04T09:01:09.015Z`
meta	object
meta.requestId	string	e.g. `pg_a61c91052ffd592f`
meta.timestamp	string	e.g. `2026-11-04T09:01:09.015Z`
meta.processingTimeMs	number	e.g. `0`
meta.dataSource	object
meta.dataSource.name	string	e.g. `ComplianceGrid`
meta.dataSource.provenance	string	e.g. `computed`

Fields are read from a real response captured 2026-11-04. Optional fields may be absent in other responses.

Errors

400 invalid request
401 missing or bad key
403 not in your plan
429 rate limited, see Retry-After
402 payment required
5xx retry with backoff

Error bodies and codes are described in Error codes and troubleshooting.

curl -X POST "https://api.compliancegrid.ai/v1/compliance/prohibited-goods" \
  -H "Authorization: Bearer $CG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "originCountry": "US",
    "destinationCountry": "CN",
    "commodityDescription": "Industrial machine tools"
  }'

Try it in the sandbox

Runs against sandbox.api.compliancegrid.ai with your own sandbox key, which stays in this browser. Sandbox responses are mock data. Get a free key.

Sandbox key

Remember for this tab

Request body (JSON)

Example response · captured from production 2026-11-04

{
  "success": true,
  "data": {
    "id": "pg_a61c91052ffd592f",
    "originCountry": "US",
    "destinationCountry": "CN",
    "commodityDescription": "Industrial machine tools",
    "hsCode": null,
    "evaluation": {
      "isProhibited": false,
      "isRestricted": false,
      "riskLevel": "LOW",
      "prohibitions": [],
      "restrictions": [],
      "warnings": []
    },
    "regulatoryReferences": [],
    "evaluatedAt": "2026-11-04T09:01:09.015Z"
  },
  "meta": {
    "requestId": "pg_a61c91052ffd592f",
    "timestamp": "2026-11-04T09:01:09.015Z",
    "processingTimeMs": 0,
    "dataSource": {
      "name": "ComplianceGrid",
      "provenance": "computed"
    }
  }
}