fourzerotwo-si Uk Trade Tariff API

UK Trade Tariff: UK commodity codes, import duties and controls by country of origin, quotas, geographical areas and HMRC monthly customs exchange rates.

Operations 6

GET /v1/uk-trade-tariff/commodity UK Trade Tariff: Commodity duties & measures #
GET /v1/uk-trade-tariff/heading UK Trade Tariff: Heading #
GET /v1/uk-trade-tariff/quotas UK Trade Tariff: Tariff-rate quotas #
GET /v1/uk-trade-tariff/areas UK Trade Tariff: Countries & groups #
GET /v1/uk-trade-tariff/exchange-rates UK Trade Tariff: HMRC customs exchange rates #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/fourzerotwo-si:fourzerotwo-si-uk-trade-tariff-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

fourzerotwo-si-uk-trade-tariff-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Fourzerotwo Si Uk Trade Tariff API
  version: 1.1.0
  contact:
    url: https://fourzerotwo.si
  description: 'Operations tagged uk-trade-tariff across 2 of this provider''s published API definitions: openapi.json, fourzerotwo-si-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://fourzerotwo.si
tags:
- name: uk-trade-tariff
  description: 'UK Trade Tariff: UK commodity codes, import duties and controls by country of origin, quotas, geographical areas and HMRC monthly customs exchange rates.'
paths:
  /v1/uk-trade-tariff/search:
    get:
      operationId: uk_trade_tariff__search
      summary: 'UK Trade Tariff: Find a commodity code'
      description: 'Candidate commodity codes, headings and chapters for a product description ("roasted coffee", "lithium battery"), best match first. Price: $0.003 USDC per call via x402. Free within the daily allowance with a free key.'
      tags:
      - uk-trade-tariff
      externalDocs:
        url: https://fourzerotwo.si/apis/uk-trade-tariff/search
      parameters:
      - name: q
        in: query
        required: true
        description: Product description
        schema:
          type: string
          maxLength: 200
        example: bicycle
      - name: limit
        in: query
        required: false
        description: Max results (default 15, max 30)
        schema:
          type: integer
      responses:
        '200':
          description: The data (paid, or free tier).
          content:
            application/json: {}
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '400':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
        '502':
          $ref: '#/components/responses/Error'
      security:
      - {}
      - freeKey: []
      x-price-usd: '0.003000'
      x-free-tier: free
      x-mcp-tool: uk-trade-tariff__search
    servers:
    - url: https://fourzerotwo.si
  /v1/uk-trade-tariff/commodity:
    get:
      operationId: uk_trade_tariff__commodity
      summary: 'UK Trade Tariff: Commodity duties & measures'
      description: 'One commodity code: description, section/chapter/heading, third-country duty and every import/export measure (preferential rates, VAT, additional duties, controls with document codes). Give country to keep only what applies to that origin. Price: $0.002 USDC per call via x402. Free within the daily allowance with a free key.'
      tags:
      - uk-trade-tariff
      externalDocs:
        url: https://fourzerotwo.si/apis/uk-trade-tariff/commodity
      parameters:
      - name: code
        in: query
        required: true
        description: Commodity code, 6–10 digits (padded to 10), e.g. 0901210000
        schema:
          type: string
          maxLength: 14
        example: 0901210000
      - name: country
        in: query
        required: false
        description: Country of origin, ISO alpha-2 (e.g. CN, US, IN) — filters measures to those that apply
        schema:
          type: string
          maxLength: 2
        example: IN
      responses:
        '200':
          description: The data (paid, or free tier).
          content:
            application/json: {}
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '400':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
        '502':
          $ref: '#/components/responses/Error'
      security:
      - {}
      - freeKey: []
      x-price-usd: '0.002000'
      x-free-tier: free
      x-mcp-tool: uk-trade-tariff__commodity
    servers:
    - url: https://fourzerotwo.si
  /v1/uk-trade-tariff/heading:
    get:
      operationId: uk_trade_tariff__heading
      summary: 'UK Trade Tariff: Heading'
      description: 'A 4-digit heading and every commodity code under it, with indents and whether each is declarable. Price: $0.002 USDC per call via x402. Free within the daily allowance with a free key.'
      tags:
      - uk-trade-tariff
      externalDocs:
        url: https://fourzerotwo.si/apis/uk-trade-tariff/heading
      parameters:
      - name: code
        in: query
        required: true
        description: 4-digit heading, e.g. 0901
        schema:
          type: string
          maxLength: 4
        example: 0901
      responses:
        '200':
          description: The data (paid, or free tier).
          content:
            application/json: {}
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '400':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
        '502':
          $ref: '#/components/responses/Error'
      security:
      - {}
      - freeKey: []
      x-price-usd: '0.002000'
      x-free-tier: free
      x-mcp-tool: uk-trade-tariff__heading
    servers:
    - url: https://fourzerotwo.si
  /v1/uk-trade-tariff/quotas:
    get:
      operationId: uk_trade_tariff__quotas
      summary: 'UK Trade Tariff: Tariff-rate quotas'
      description: 'Quota definitions with status (open, exhausted, critical), initial volume, remaining balance and validity, by order number or country of origin. Price: $0.002 USDC per call via x402. Free within the daily allowance with a free key.'
      tags:
      - uk-trade-tariff
      externalDocs:
        url: https://fourzerotwo.si/apis/uk-trade-tariff/quotas
      parameters:
      - name: order_number
        in: query
        required: false
        description: 6-digit quota order number
        schema:
          type: string
          maxLength: 6
        example: '050006'
      - name: country
        in: query
        required: false
        description: Country of origin, ISO alpha-2
        schema:
          type: string
          maxLength: 2
      - name: status
        in: query
        required: false
        description: open, exhausted, blocked, critical or not_exhausted
        schema:
          type: string
          maxLength: 16
      - name: page
        in: query
        required: false
        description: Page
        schema:
          type: integer
      responses:
        '200':
          description: The data (paid, or free tier).
          content:
            application/json: {}
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '400':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
        '502':
          $ref: '#/components/responses/Error'
      security:
      - {}
      - freeKey: []
      x-price-usd: '0.002000'
      x-free-tier: free
      x-mcp-tool: uk-trade-tariff__quotas
    servers:
    - url: https://fourzerotwo.si
  /v1/uk-trade-tariff/areas:
    get:
      operationId: uk_trade_tariff__areas
      summary: 'UK Trade Tariff: Countries & groups'
      description: 'Tariff geographical areas: countries and the groups used in measures (e.g. 1011 ERGA OMNES, 1013 European Union, trade agreements), with group members. Price: $0.002 USDC per call via x402. Free within the daily allowance with a free key.'
      tags:
      - uk-trade-tariff
      externalDocs:
        url: https://fourzerotwo.si/apis/uk-trade-tariff/areas
      parameters:
      - name: kind
        in: query
        required: false
        description: all, countries or groups
        schema:
          type: string
          maxLength: 10
        example: groups
      - name: q
        in: query
        required: false
        description: Filter by name or id
        schema:
          type: string
          maxLength: 80
      responses:
        '200':
          description: The data (paid, or free tier).
          content:
            application/json: {}
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '400':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
        '502':
          $ref: '#/components/responses/Error'
      security:
      - {}
      - freeKey: []
      x-price-usd: '0.002000'
      x-free-tier: free
      x-mcp-tool: uk-trade-tariff__areas
    servers:
    - url: https://fourzerotwo.si
  /v1/uk-trade-tariff/exchange-rates:
    get:
      operationId: uk_trade_tariff__exchange_rates
      summary: 'UK Trade Tariff: HMRC customs exchange rates'
      description: 'HMRC''s monthly exchange rates used to convert invoice values for customs and import VAT, units per £1. Price: $0.002 USDC per call via x402. Free within the daily allowance with a free key.'
      tags:
      - uk-trade-tariff
      externalDocs:
        url: https://fourzerotwo.si/apis/uk-trade-tariff/exchange-rates
      parameters:
      - name: year
        in: query
        required: true
        description: Year
        schema:
          type: integer
        example: 2026
      - name: month
        in: query
        required: true
        description: Month 1–12
        schema:
          type: integer
        example: 9
      - name: currency
        in: query
        required: false
        description: 'ISO currency code, e.g. USD (default: all)'
        schema:
          type: string
          maxLength: 3
        example: USD
      responses:
        '200':
          description: The data (paid, or free tier).
          content:
            application/json: {}
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '400':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
        '502':
          $ref: '#/components/responses/Error'
      security:
      - {}
      - freeKey: []
      x-price-usd: '0.002000'
      x-free-tier: free
      x-mcp-tool: uk-trade-tariff__exchange-rates
    servers:
    - url: https://fourzerotwo.si
components:
  responses:
    PaymentRequired:
      description: x402 payment required. The body (also base64 in the PAYMENT-REQUIRED header) lists accepted payments.
      headers:
        PAYMENT-REQUIRED:
          schema:
            type: string
          description: Base64 JSON x402 v2 PaymentRequired
      content:
        application/json:
          schema:
            type: object
            properties:
              x402Version:
                type: integer
              error:
                type: string
              accepts:
                type: array
                items:
                  type: object
    Error:
      description: 400 = invalid input, 404 = not found at the source, 502 = the source failed. Never charged.
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: string
              charged:
                type: boolean
  securitySchemes:
    freeKey:
      type: apiKey
      in: header
      name: X-API-Key
      description: Optional free key (fzt_…) for the free tier.
x-refined-from:
- openapi.json
- fourzerotwo-si-openapi.json