Get Shipping Restrictions Across Countries

This API helps determine if the item has regulatory, legal, or carrier-based restrictions for multiple destination countries.
Use this API to determine which countries are available for listing, and/or perform screenings to determine shipping compliance for crossborder transactions. Responses include restrictions and prohibitions for CITES, Health, Limited Quantity, Hazmat & Dangerous Goods, ITAR and Medical related regulations.

SecuritybearerAuth

Request

header Parameters

X-PB-TransactionId	string A unique Transaction ID provided by the partner, which is used to enable debugging and linking between the client's transaction and the system.Allowed characters limit is 36.
Content-Type required	string The media type of the request body. Value: "application/json"

Request Body schema: application/json

exportCountryCode required	string [ 2 .. 3 ] characters The country from which the shipment is exported. Must be a valid ISO 3166-1 alpha-2 or alpha-3 country code (e.g., US or USA). Maximum 250 coutries can be passed in the list.
required	Array of objects List of destination country details. Each object includes destination country code and its associated HS tariff code.
required	object The item being evaluated for shipping restrictions.

Responses

200

The requested restriction has been retrived successfully.

400

Invalid request.

401

The request could not be authorized.

500

The request could not be completed due to an internal error.

post/api/v1/crossborder-services/restriction/bulk

Request samples

application/json

{"exportCountryCode": "US",
"destinationCountries": [{"destinationCountryCode": "CL",
"hsTariffCode": "420211888"
},
{"destinationCountryCode": "CA",
"hsTariffCode": "010121"
},
{"destinationCountryCode": "MX",
"hsTariffCode": "10000000"
}
],
"item": {"itemId": "ITEM-1234",
"condition": "NEW"
}
}

Response samples

application/json

{"exportCountryCode": "US",
"item": {"itemId": "ITEM-1234",
"countryRestrictions": [{"destinationCountryCode": "ALL",
"restrictions": [{"restrictionType": "EXPORT",
"regulation": "RESTRICTED",
"category": "CITES",
"requirement": "EXPORT PERMIT; FW1",
"complianceMessage": "CITES"
}
]
},
{"destinationCountryCode": "CL",
"restrictions": [{"restrictionType": "IMPORT",
"regulation": "RESTRICTED",
"category": "CITES",
"requirement": "IMPORT PERMIT; FW1",
"agencies": ["Chilean Ministry of Health and the Chilean Agricultural and Livestock Service."
],
"complianceMessage": "CITES: Health and veterinary permits are issued by the Chilean Ministry of Health and the Chilean Agricultural and Livestock Service. - Chilean Ministry of Health and the Chilean Agricultural and Livestock Service: https://www.gob.cl/en/ministries/ministry-of-health/ or http://www.minsal.cl and http://www.sag.gob.cl"
}
]
},
{"destinationCountryCode": "ALL",
"restrictions": [{"restrictionType": "EXPORT",
"regulation": "RESTRICTED",
"category": "HEALTH",
"requirement": "LICENSE; FD3; AP2",
"complianceMessage": "Export license (Veterinary Health Certificate)"
}
]
},
{"destinationCountryCode": "CA",
"restrictions": [{"restrictionType": "IMPORT",
"regulation": "RESTRICTED",
"category": "HEALTH",
"requirement": "FORMAL ENTRY; FD3; AP2",
"agencies": ["Canadian Food Inspection Agency."
],
"complianceMessage": "Import restricted (Veterinary Health Certificate): Import restrictions requiring health certificates are overseen by the Canadian Food Inspection Agency. - Canadian Food Inspection Agency: https://inspection.canada.ca/en"
}
]
},
{"destinationCountryCode": "MX",
"restrictions": [ ]
}
]
}
}