---
title: "Search tariffs by product description"
method: GET
path: "/api/v1/external/tariffs/search"
tags: ["Tariffs"]
---

# Search tariffs by product description

`GET /api/v1/external/tariffs/search`

## Request

- Base URL: `https://api.wove.com`
- URL: `https://api.wove.com/api/v1/external/tariffs/search`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/wove/apis/wove-external-api/docs/api/v1/external/tariffs/search/get.ts> (a function with typed inputs; its response is checked against the schema)

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.

## Query parameters

- `q` string, required
- `country` string, required
- `limit` integer
- `entryDate` string, date
- `dateOfLoading` string, date
- `prefix` string

## Response `200`

Search results retrieved successfully

- object
  - `success` boolean
  - `data` object
    - `results` object[]
      - `id` string
      - `code` string
      - `description` string
      - `fullDescription` string
      - `similarity` number: Relevance score (0-1)

## Other responses

- `400`: Bad request - invalid parameters
- `401`: Authentication required
- `403`: Insufficient permissions - requires tariffs:read scope

---

[API](https://skmtc.dev/wove/apis/wove-external-api.md) - [All operations](https://skmtc.dev/wove/apis/wove-external-api/llms.txt) - [OpenAPI document](https://skmtc.dev/wove/apis/wove-external-api/revisions/37290e267e07?raw)