curl --request POST \
--url https://api.teleship.com/api/trade-engine/hts-compliance \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"originCountry": "CN",
"products": [
{
"hsCode": "8471300100",
"countryOfOrigin": "CN"
}
]
}
'{
"compliance": [
{
"itemNumber": 123,
"hsCode": "<string>",
"restrictions": [
{
"importRegion": "<string>",
"flag": "<string>",
"importRisk": "<string>",
"id": "<string>",
"countryOfOrigin": "AF",
"hts": "<string>",
"chapter": "<string>",
"message": "<string>",
"info": "<string>",
"capture": "<string>",
"metadata": {},
"serviceCode": "TELESHIP-EXPEDITED-PICKUP",
"shippingMethod": "RM-RETURN-T24",
"restrictionLevel": "FALSE",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}
],
"productId": "<string>"
}
]
}{
"messages": [
{
"code": 123,
"level": "error",
"timestamp": "2024-01-01T00:00:00.00Z",
"message": "An error occurred",
"details": [
"Missing required field"
]
}
]
}{
"messages": [
{
"code": 123,
"level": "error",
"timestamp": "2024-01-01T00:00:00.00Z",
"message": "An error occurred",
"details": [
"Missing required field"
]
}
]
}{
"messages": [
{
"code": 123,
"level": "error",
"timestamp": "2024-01-01T00:00:00.00Z",
"message": "An error occurred",
"details": [
"Missing required field"
]
}
]
}Trade engine
Get HTS restrictions for products
Retrieve HTS/HS code restrictions for multiple products without performing classification.
What you get:
- Import restrictions and compliance requirements for each product
- Region-specific filtering (US, EU27, ROW)
- Review state tracking (if productId/variantId provided)
- Progressive HTS code matching for maximum coverage
Use case: Identify import restrictions, licensing requirements, and compliance obligations for products with existing HS codes.
Key Features:
- Destination country filtering: Filter restrictions by destination and additional regions
- Review state: Track which restrictions have been reviewed by merchants
- Flexible lookup: Match products by productId, variantId, or hsCode
- Progressive matching: Matches HS codes at multiple specificity levels (e.g., 8471.30.01 → 8471.30 → 8471)
Note: Unlike the classifications endpoint, this does NOT perform HS code classification. Use this when you already have HS codes and only need restrictions.
POST
/
api
/
trade-engine
/
hts-compliance
curl --request POST \
--url https://api.teleship.com/api/trade-engine/hts-compliance \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"originCountry": "CN",
"products": [
{
"hsCode": "8471300100",
"countryOfOrigin": "CN"
}
]
}
'{
"compliance": [
{
"itemNumber": 123,
"hsCode": "<string>",
"restrictions": [
{
"importRegion": "<string>",
"flag": "<string>",
"importRisk": "<string>",
"id": "<string>",
"countryOfOrigin": "AF",
"hts": "<string>",
"chapter": "<string>",
"message": "<string>",
"info": "<string>",
"capture": "<string>",
"metadata": {},
"serviceCode": "TELESHIP-EXPEDITED-PICKUP",
"shippingMethod": "RM-RETURN-T24",
"restrictionLevel": "FALSE",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}
],
"productId": "<string>"
}
]
}{
"messages": [
{
"code": 123,
"level": "error",
"timestamp": "2024-01-01T00:00:00.00Z",
"message": "An error occurred",
"details": [
"Missing required field"
]
}
]
}{
"messages": [
{
"code": 123,
"level": "error",
"timestamp": "2024-01-01T00:00:00.00Z",
"message": "An error occurred",
"details": [
"Missing required field"
]
}
]
}{
"messages": [
{
"code": 123,
"level": "error",
"timestamp": "2024-01-01T00:00:00.00Z",
"message": "An error occurred",
"details": [
"Missing required field"
]
}
]
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
Origin country of the commodities
Available options:
AF, AL, DZ, AS, AC, AD, AO, AI, AQ, AG, AR, AM, AW, AU, AT, AZ, BS, BH, BD, BB, BY, BE, BZ, BJ, BM, BT, BO, BA, BW, BV, BR, IO, BN, BG, BF, BI, KH, CM, CA, CV, KY, CF, TD, CL, CN, CX, CC, CO, KM, CG, CD, CK, CR, CI, HR, CU, CY, CZ, DK, DJ, DM, DO, EC, EG, EL, SV, GQ, ER, EE, ET, FK, FO, FJ, FI, FR, GF, PF, TF, GA, GM, GE, DE, GH, GI, GR, GL, GD, GP, GU, GT, GG, GN, GW, GY, HT, HM, VA, HN, HK, HU, IS, IN, ID, IR, IQ, IE, IM, IL, IT, JM, JP, JE, JO, KZ, KE, KI, KP, KR, KW, KG, LA, LV, LB, LS, LR, LY, LI, LT, LU, MO, MK, MG, MW, MY, MV, ML, MT, MH, MQ, MR, MU, YT, MX, FM, MD, MC, MN, ME, MS, MA, MZ, MM, NA, NR, NP, NL, AN, NC, NZ, NI, NE, NG, NU, NF, MP, NO, OM, PK, PW, PS, PA, PG, PY, PE, PH, PN, PL, PT, PR, QA, RE, RO, RU, RW, SH, KN, LC, PM, VC, WS, SM, ST, SA, SN, RS, SC, SL, SG, SK, SI, SB, SO, ZA, GS, ES, LK, SD, SR, SJ, SZ, SE, CH, SY, TW, TJ, TZ, TH, TL, TG, TK, TO, TT, TN, TR, TM, TC, TV, UG, UA, AE, GB, US, UM, UY, UZ, VU, VE, VN, VG, VI, WF, EH, YE, ZM, ZW Array of products to get compliance data for (max 20)
Maximum array length:
20Show child attributes
Show child attributes
Destination country of the commodities
Available options:
All, US, GB, EU, AU, CA, AT, BE, BG, HR, CY, CH, CZ, DK, EE, FI, FR, DE, GR, HU, IE, IT, LV, LT, LU, MT, NL, PL, PT, RO, SK, SI, ES, SE, IS, LI, NO, NZ, SG, HK, AE, SA Response
List of products compliance data
Show child attributes
Show child attributes
Was this page helpful?