WOwove
Tariffs

Search tariffs by product description

Search for tariff lines using semantic search on product descriptions.

This endpoint uses AI-powered semantic search to find relevant HS codes based on natural language product descriptions. Results are ranked by relevance to the search query.

Supply prefix to constrain the search to a subtree of the tariff schedule. This is useful when the heading is already known and only the statistical suffix is in question — the semantic query then ranks lines within that subtree instead of across the whole schedule.

Note: This endpoint excludes Chapter 99 codes (9903.xx.xx) as they are administrative tariff codes, not product classifications.

get/api/v1/external/tariffs/search

Request

Query parameters

qstring required

Product description to search for

countrystring required

Destination country code (2-letter ISO)

limitinteger

Maximum number of results (max 50)

entryDatestring date

Entry date for historical rate lookup (ISO date)

dateOfLoadingstring date

Date of loading for historical rate lookup

prefixstring

Anchor results to an HS code prefix. Only tariff lines whose code begins with this prefix are returned; the semantic query still ranks the results within that subtree. Accepts 2-10 digits, dots optional (6109 and 6109.10 are both valid). q is still required.

Response

Search results retrieved successfully

successboolean

Example response

{
  "success": true,
  "data": {
    "results": [
      {
        "code": "8471.30.01.00",
        "description": "Portable automatic data processing machines",
        "similarity": 0.89
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.