⚙️

Restricted Items

ActiveCoreMUSTFREE

What it does

Screen products against import restrictions and prohibited item lists for any destination country. The system checks HS code-based restrictions, product category bans, and country-specific regulations. Covers dangerous goods, controlled substances, weapons, and culturally sensitive items across 240 countries.

Required Fields for 100% Accuracy

1 required / 3 total

Field	Type	Required	Description	Example
`destinationCountry`	string	!	Destination country (ISO 2-letter code)	`AU`
`hsCode`	string	opt	HS code (2-10 digits)Provide hsCode for exact restriction lookup. Without it, productName is auto-classified.	`9304.00`
`productName`	string	opt	Product name (used if hsCode not provided)Required if hsCode is not provided.	`Air rifle`

Tips for Best Accuracy

✓destinationCountry is the only required field
✓Providing hsCode directly gives faster, more precise results than auto-classification
✓If neither hsCode nor productName is provided, the request will fail

Common Mistakes

✗Omitting both hsCode and productName — at least one must be provided
✗Using 3-letter country codes — use ISO 2-letter codes (AU not AUS)

How to use it

Provide product details

Include the HS code and/or product name with the destination country.

Call the restrictions endpoint

POST /api/v1/restrictions returns whether the product has import restrictions.

Check prohibition status

The isProhibited field tells you if the product is completely banned in the destination.

Review license requirements

Some restricted items can be imported with a license — check requiresLicense in the response.

API Reference

POST/api/v1/restrictions

Request

{
  "hsCode": "9304.00",
  "destinationCountry": "AU",
  "productName": "Air rifle"
}

Response

{
  "hasRestrictions": true,
  "isProhibited": false,
  "restrictions": [
    {
      "type": "firearms_control",
      "description": "Requires import permit from Australian Border Force",
      "requiresLicense": true
    }
  ],
  "hsCode": "9304.00",
  "destinationCountry": "AU"
}

cURL

curl -X POST https://potal.app/api/v1/restrictions \
  -H "X-API-Key: pk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"hsCode":"9304.00","destinationCountry":"AU","productName":"Air rifle"}'

Related Features

🌐Country Prohibitions

Enforce country-specific import bans and product restrictions

🌐Dangerous Goods Flag

Flag hazardous materials and dangerous goods restrictions

🌐Sanctions Screening

Screen against OFAC SDN, BIS Entity List, and 19 global sources

🌐Export Controls

EAR/ITAR export control classification and license determination

🌐Pre-shipment Check

Comprehensive screening before shipping: cost + compliance

Having issues?

🐛 Report a Bug ❓ Ask a Question 💡 Suggest Improvement