API documentation Tariffs

Contents

• List tariffs
• Test tariff

List tariffs

Provides a way to search for tariffs using a product's taric/HS code or description.

When a full 10-digit taric code is provided, the first result will be the exact match if available, followed by other tariffs with the same initial 6-digit HS code, ordered by nearest matches and then by popularity (= overall line items count). Fewer provided digits yield broader matches.

Description search is case-insensitive and will return all tariffs that contain the provided text in their description, ordered by popularity (= overall line items count).

Note: TARIC codes are synchronized with the Customs database daily. Due to this, the actual response payload might vary over time, even with the same query parameters. This behavior is expected.

Endpoint

[GET] /v4/tariffs?q={taric_code_or_description}

Attributes

Key	Description	Datatype	Constraints/Remarks
taric	Taric code	String	Search by the first 6 digits for broad categorization
original_description	Original description	String	Search by text description of the product

Example

Request

[GET] /v4/tariffs?q=8529909700

Response

[
  \[
      {
        "taric": "8529909700",
        "original_description": "ELECTRICAL MACHINERY AND EQUIPMENT AND PARTS THEREOF; SOUND RECORDERS AND REPRODUCERS, TELEVISION IMAGE AND SOUND RECORDERS AND REPRODUCERS, AND PARTS AND ACCESSORIES OF SUCH ARTICLESParts suitable for use solely or principally with the apparatus of headings|8525|to 8528OtherOther"
      },
      {
        "taric": "8529909100",
        "original_description": "ELECTRICAL MACHINERY AND EQUIPMENT AND PARTS THEREOF; SOUND RECORDERS AND REPRODUCERS, TELEVISION IMAGE AND SOUND RECORDERS AND REPRODUCERS, AND PARTS AND ACCESSORIES OF SUCH ARTICLESParts suitable for use solely or principally with the apparatus of headings|8525|to 8528OtherLight-emitting diode (LED) backlight modules, which are lighting sources that consist of one or more LEDs, and one or more connectors and are mounted on a printed circuit or other similar substrate, and other passive components, whether or not combined with optical components or protective diodes, and used as backlight illumination for liquid crystal displays (LCDs)"
      },
      { ...and so on...}
  \]
]

Test tariff

Tests whether a specific tariff by its taric code is admissible. Returns a 200 status code if the tariff is found and admissible, or a 404 status code if not found.

Note: TARIC codes are synchronized with the Customs database daily. Due to this, the actual response payload might vary over time, even with the same query parameters. This behavior is expected.

Endpoint

[GET] /v4/tariffs/{taric_code}

Attributes

No specific attributes are returned. The endpoint is used only to test acceptance, and will return a 200 or 404 response depending on the admissibility of the specified tariff.

Example: Show tariff

Request

curl -sIX GET "https://app.viaeurope.com/api/v4/tariffs/8529909700" -H "Accept: application/json" -H "Authorization: Token YOUR_API_TOKEN_HERE" | grep HTTP

Response

HTTP/1.1 200 OK