---
title: "GetBilateralTariff"
method: GET
path: "/api/trade/v1/get-bilateral-tariff"
tags: ["TradeService"]
---

# GetBilateralTariff

`GET /api/trade/v1/get-bilateral-tariff`

## Request

- Base URL: `https://api.worldmonitor.app`
- URL: `https://api.worldmonitor.app/api/trade/v1/get-bilateral-tariff`
- Auth: one of:
  - API key in header `X-WorldMonitor-Key`
  - API key in header `X-Api-Key`
  - HTTP bearer

Applied tariff on one HS6 product between two countries (UNCTAD TRAINS). PRO-gated. Requires entitlement tier >= 1.

## Query parameters

- `reporting_country` string, required
- `partner_country` string, required
- `hs_code` string, required
- `year` integer
- `jmespath` string

## Response `200`

OK

- WorldmonitorTradeV1GetBilateralTariffResponse: Applied tariff on one HS6 product between two countries.
  - `reportingCountry` string: Importer code, as requested.
  - `partnerCountry` string: Exporter code, as requested.
  - `hsCode` string: HS6 code, as requested.
  - `year` integer: Year served; 0 when none.
  - `nomenclature` string: HS edition the importer filed in ("H5" = HS 2017).
  - `basis` 'APPLIED_TARIFF_BASIS_UNSPECIFIED' | 'APPLIED_TARIFF_BASIS_PREFERENTIAL' | 'APPLIED_TARIFF_BASIS_MFN' | 'APPLIED_TARIFF_BASIS_MFN_PREFERENCES_NOT_REPORTED': Source of applied_rate.
  - `appliedRate` WM52: Simple average across the importer's national tariff lines, in percent.
    - `rate` number, double: Average ad valorem rate.
    - `minRate` number, double: Lowest line rate.
    - `maxRate` number, double: Highest line rate.
    - `tariffLines` integer: National tariff lines.
    - `nonAdValoremLines` integer: Specific or compound lines, excluded from the average.
  - `mfnRate` WM52: Simple average across the importer's national tariff lines, in percent.
    - `rate` number, double: Average ad valorem rate.
    - `minRate` number, double: Lowest line rate.
    - `maxRate` number, double: Highest line rate.
    - `tariffLines` integer: National tariff lines.
    - `nonAdValoremLines` integer: Specific or compound lines, excluded from the average.
  - `preferentialRate` WM52: Simple average across the importer's national tariff lines, in percent.
    - `rate` number, double: Average ad valorem rate.
    - `minRate` number, double: Lowest line rate.
    - `maxRate` number, double: Highest line rate.
    - `tariffLines` integer: National tariff lines.
    - `nonAdValoremLines` integer: Specific or compound lines, excluded from the average.
  - `groupPreferences` WorldmonitorTradeV1GroupTariffPreference[]
    - `groupCode` string: WITS group code ("A41").
    - `groupName` string: WITS group name; empty when WITS has none.
    - `rate` WM52: Simple average across the importer's national tariff lines, in percent.
      - `rate` number, double: Average ad valorem rate.
      - `minRate` number, double: Lowest line rate.
      - `maxRate` number, double: Highest line rate.
      - `tariffLines` integer: National tariff lines.
      - `nonAdValoremLines` integer: Specific or compound lines, excluded from the average.
  - `source` string: Data source.
  - `sourceUrl` string: WITS query behind the rows.
  - `upstreamUnavailable` boolean: True on a fault, false on a coverage answer.
  - `unavailableReason` 'BILATERAL_TARIFF_UNAVAILABLE_REASON_UNSPECIFIED' | 'BILATERAL_TARIFF_UNAVAILABLE_REASON_INVALID_REQUEST' | 'BILATERAL_TARIFF_UNAVAILABLE_REASON_NOT_COVERED' | 'BILATERAL_TARIFF_UNAVAILABLE_REASON_UPSTREAM_UNAVAILABLE': Why no rate was served. NOT_COVERED is final; UPSTREAM_UNAVAILABLE is a fault.
  - `filingReporter` string: Reporter code queried: "918" for EU members.
  - `mfnAveRate` WM52: Simple average across the importer's national tariff lines, in percent.
    - `rate` number, double: Average ad valorem rate.
    - `minRate` number, double: Lowest line rate.
    - `maxRate` number, double: Highest line rate.
    - `tariffLines` integer: National tariff lines.
    - `nonAdValoremLines` integer: Specific or compound lines, excluded from the average.

## Other responses

- `400`: Validation error
- `401`: Missing or invalid API key.
- `403`: PRO entitlement access denied.
- `429`: Rate limit exceeded.
- `503`: Service unavailable. Billing-verification responses include code and X-Billing-Verification; other gateway infrastructure failures use the generic GatewayError shape.
- `default`: Gateway or handler error response.

---

[API](https://skmtc.dev/worldmonitor/apis/worldmonitor-api.md) · [All operations](https://skmtc.dev/worldmonitor/apis/worldmonitor-api/llms.txt) · [OpenAPI document](https://skmtc.dev/worldmonitor/apis/worldmonitor-api/revisions/e3dc8463a5c9?raw)