API Reference

HS Codes and MFN Import Duty (BTKI 2022)

11,545 eight-digit HS codes from BTKI 2022 (PMK 26/PMK.010/2022) with the MFN import duty rate.

Data as of · Source: PMK 26/PMK.010/2022 (BTKI 2022)

Main endpoint
GET https://use.apiindonesia.id/api/v1/hs/bab
Endpoints
3
Authentication
x-api-key header (create one free in the dashboard)
Price
2 credits (Rp2) per successful request; failed requests are free
Format
JSON (REST), with cURL, JavaScript and Python examples
Data source
Source: BTKI 2022, annex of PMK 26/PMK.010/2022 (regulations are not copyrighted); The annex was parsed from the official JDIH Kemenkeu PDF; the annex page is recorded in validasi_catatan on every row; Satuan is filled only when the annex states a unit, so most rows have null; Later PMK rate changes are not applied yet; for customs work always check the current regulation; Every response carries meta.attribution
Product Brief

What this API gives you

11,545 eight-digit HS codes from BTKI 2022 (PMK 26/PMK.010/2022) with the MFN import duty rate.

  • 99 chapters, each with its 4-digit tariff heading and Indonesian and English descriptions
  • Search by code (0901, 8517.13.00) or by words in the description, then filter by chapter or heading
  • The duty is given as a number (bea_masuk_mfn) and as the annex text (bea_masuk_raw)
  • Descriptions were parsed from an OCR of the annex, so some words are misread
  • Later PMK rate changes are not applied yet; check the regulation before using it for customs
  • Source: BTKI 2022, annex of PMK 26/PMK.010/2022 (regulations are not copyrighted)
  • The annex was parsed from the official JDIH Kemenkeu PDF; the annex page is recorded in validasi_catatan on every row
  • Satuan is filled only when the annex states a unit, so most rows have null
  • Later PMK rate changes are not applied yet; for customs work always check the current regulation
  • Every response carries meta.attribution
Coverage
3

ready-to-use endpoints in this product, with JSON responses and consistent error handling.

Access
API key

Can be tried with the 3,000 credit signup bonus, then used in production through one API Indonesia key.

Sample resource
https://use.apiindonesia.id/api/v1/hs/bab

Returns the 99 BTKI chapters with their section, Indonesian and English descriptions and the number of tariff lines per chapter. Useful for building navigation before filtering codes.

Example product scenarios

This section separates the product page from the docs. The docs explain how to call endpoints; this page explains why the endpoints make sense for your feature.

  • Duty calculators: pull the MFN rate per HS code to estimate import cost before shipping.
  • Product classification: find an HS code from words in the description, then trace its chapter and tariff heading.
  • Catalogue & PIM: complete export-import product records with their HS code and reference duty rate.

Example Usage

Request
curl "https://use.apiindonesia.id/api/v1/hs/bab" \
  -H "x-api-key: YOUR_API_KEY"
Response · 200 OK
{
  "success": true,
  "data": [
    {
      "bab": "01",
      "bagian": "I",
      "uraian_id": "Binatang hidup",
      "uraian_en": "Live animals",
      "jumlah_pos_tarif": 53
    },
    {
      "bab": "02",
      "bagian": "I",
      "uraian_id": "Daging dan sisa daging yang dapat dimakan",
      "uraian_en": "Meat and edible meat offal",
      "jumlah_pos_tarif": 83
    }
  ],
  "meta": {
    "attribution": {
      "source": "Buku Tarif Kepabeanan Indonesia (BTKI) 2022, lampiran PMK 26/PMK.010/2022 dan perubahannya",
      "license": "Peraturan perundang-undangan, tidak dilindungi hak cipta (UU 28/2014 Pasal 42)",
      "license_url": "https://peraturan.bpk.go.id/Details/5031/uu-no-28-tahun-2014",
      "source_url": "https://jdih.kemenkeu.go.id",
      "attribution_page": "https://apiindonesia.id/produk/hs/",
      "notice": "Data diubah: lampiran PMK diurai ke format JSON oleh API Indonesia; cek peraturan terbaru sebelum dipakai untuk keperluan pabean",
      "sources": [
        {
          "name": "PMK 26/PMK.010/2022 (BTKI 2022)",
          "url": "https://jdih.kemenkeu.go.id",
          "used_for": "kode HS, uraian, tarif bea masuk MFN"
        }
      ]
    }
  }
}

Related Articles

Pricing 2 credits (Rp2) per successful request; failed requests are free. One-time 3,000 credit signup bonus, no credit card, no monthly allowance.

HS Codes and MFN Import Duty (BTKI 2022) API questions

Does the duty include later PMK changes?

Not yet. The rates come from the BTKI 2022 annex and later PMK rate changes are not applied, so check the current regulation before using them for customs.

Why is a word misspelled in the description?

Descriptions were parsed from an OCR of the PDF annex, so some words are misread. Codes and rates still come from the official annex, and validasi_catatan names the page.

Can I search an HS code written with dots?

Yes. q accepts 2 to 8 digits with or without dots (0901.21.10), and the detail endpoint accepts 8 digits with or without dots. The bab and pos filters use digits only.

Get Started

Start Integrating
Today

Sign up for free and get a 3,000 credit bonus (Rp3,000) once your email is verified, grab an API key, and call your first endpoint right away. No credit card, no tedious approval process.

Dot wave visualization