> ## Documentation Index > Fetch the complete documentation index at: https://developers.teleship.com/llms.txt > Use this file to discover all available pages before exploring further. # 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. ## OpenAPI ````yaml /api-reference/openapi.json post /api/trade-engine/hts-compliance openapi: 3.0.0 info: title: Teleship description: > Teleship is a leading cross-border logistics provider offering seamless global commerce solutions through our comprehensive API. With Teleship's API, developers can integrate our cross-border shipping services, trade engine, and logistics solutions directly into their applications. **Key Features:** - Cross-border shipping solutions for international commerce - Real-time shipping rates and delivery estimates - End-to-end shipment tracking with detailed status updates - Automated customs compliance and product classification - Real-time event notifications through webhooks **Why Teleship?** - API-first: Developer-friendly integration with comprehensive documentation - Enterprise-ready: Built for businesses of all sizes - Secure: Enterprise-grade security and compliance - Integrated: Seamless connection with e-commerce, ERP, and fulfillment systems Start shipping globally with Teleship's powerful cross-border logistics API. version: 1.0.0 contact: {} servers: - url: https://api.teleship.com security: [] tags: [] paths: /api/trade-engine/hts-compliance: post: tags: - Trade Engine summary: Get HTS restrictions for products description: > 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. operationId: getHTSRestrictions parameters: [] requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ProductComplianceRequestDto' examples: BasicRequest: summary: Basic HTS compliance lookup (no review state) value: originCountry: CN products: - hsCode: '8471300100' countryOfOrigin: CN WithProductIds: summary: HTS compliance with product IDs for review state lookup value: originCountry: CN products: - hsCode: '8471300100' countryOfOrigin: CN productId: shopify_prod_7234567890 variantId: shopify_var_4567890123 - hsCode: '6203421000' countryOfOrigin: GB productId: woo_prod_12345 WithDestination: summary: HTS compliance filtered by destination country value: originCountry: CN destinationCountry: US products: - hsCode: '8471300100' countryOfOrigin: CN productId: shopify_prod_7234567890 - hsCode: '6203421000' countryOfOrigin: GB productId: prod_trousers_001 - hsCode: '9503004100' countryOfOrigin: DE productId: prod_toy_001 variantId: shopify_var_9876543210 MultipleProducts: summary: Bulk HTS compliance lookup with mixed identifiers value: originCountry: CN destinationCountry: US products: - hsCode: '8471300100' countryOfOrigin: CN productId: prod_laptop_001 variantId: var_laptop_512gb - hsCode: '6301401000' countryOfOrigin: GB productId: prod_bedding_001 - hsCode: '9503004100' countryOfOrigin: DE productId: prod_toy_015 - hsCode: '3304990000' countryOfOrigin: FR productId: prod_cosmetic_001 variantId: var_cosmetic_50ml responses: '200': description: '' content: application/json: schema: $ref: '#/components/schemas/ProductComplianceResponsetDto' '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/ResponseMessagesDto' '403': description: Forbidden content: application/json: schema: $ref: '#/components/schemas/ResponseMessagesDto' '500': description: Internal server error content: application/json: schema: $ref: '#/components/schemas/ResponseMessagesDto' security: - bearer: [] components: schemas: ProductComplianceRequestDto: type: object properties: originCountry: type: string description: Origin country of the commodities enum: - 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 destinationCountry: type: string description: Destination country of the commodities enum: - 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 products: description: Array of products to get compliance data for (max 20) maxItems: 20 type: array items: $ref: '#/components/schemas/ComplianceDataDto' required: - originCountry - products ProductComplianceResponsetDto: type: object properties: compliance: description: List of products compliance data type: array items: $ref: '#/components/schemas/ProductComplianceResultDto' required: - compliance ResponseMessagesDto: type: object properties: messages: type: array items: $ref: '#/components/schemas/ErrorResponseDto' required: - messages ComplianceDataDto: type: object properties: countryOfOrigin: type: string description: Country of origin enum: - 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 sku: type: string description: Stock Keeping Unit hsCode: type: string description: Harmonized System Code variantId: type: string description: Variant ID inventoryId: type: string description: Inventory ID classification: description: Product classification with HS codes allOf: - $ref: '#/components/schemas/ClassificationDto' productId: type: string description: Product ID (for review state lookup) required: - hsCode ProductComplianceResultDto: type: object properties: itemNumber: type: number description: Item number hsCode: type: string description: Harmonized System Code restrictions: description: HS Code restrictions type: array items: $ref: '#/components/schemas/RestrictionFlagsEntryDto' productId: type: string description: Product ID required: - itemNumber - hsCode ErrorResponseDto: type: object properties: code: type: number level: type: string enum: - error - warning - info example: error description: Error level default: error timestamp: format: date-time type: string example: '2024-01-01T00:00:00.00Z' message: type: string example: An error occurred details: example: - Missing required field type: array items: type: string required: - code - level - timestamp - message - details ClassificationDto: type: object properties: sixDigitHSCode: type: string description: Six digit HS Code originHSCode: type: string description: Origin HS Code deprecated: true destinationHSCode: type: string description: Destination HS Code deprecated: true originCode: description: Origin code allOf: - $ref: '#/components/schemas/HSCodeDto' destinationCode: description: Destination code allOf: - $ref: '#/components/schemas/HSCodeDto' regionalCodes: description: Region codes type: array items: $ref: '#/components/schemas/HSCodeDto' RestrictionFlagsEntryDto: type: object properties: id: type: string importRegion: type: string description: The import region flag: type: string description: The restriction flag status importRisk: type: string description: The import risk level countryOfOrigin: $ref: '#/components/schemas/Country' hts: type: string description: The hts information chapter: type: string description: The chapter information message: type: string description: Detailed restriction message info: type: string description: Additional information capture: type: string description: Capture type metadata: type: object description: Additional metadata serviceCode: type: string description: Service code for route-specific restrictions example: TELESHIP-EXPEDITED-PICKUP shippingMethod: type: string description: Shipping method for route-specific restrictions example: RM-RETURN-T24 restrictionLevel: $ref: '#/components/schemas/RestrictionLevel' createdAt: format: date-time type: string updatedAt: format: date-time type: string required: - importRegion - flag - importRisk HSCodeDto: type: object properties: hsCode: type: string description: Harmonized System Code region: type: object description: Region code required: - hsCode Country: type: string description: The country of origin enum: - 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 RestrictionLevel: type: string description: Restriction level for this commodity enum: - 'FALSE' - 'TRUE' - ACCOUNT - All securitySchemes: bearer: scheme: bearer bearerFormat: JWT type: http ````