{
  "openapi": "3.1.0",
  "info": {
    "title": "Tariff Codes API",
    "version": "1.0.0",
    "description": "All 35,804 lines of the US Harmonized Tariff Schedule with duty rates, searchable.\n\nThe complete US Harmonized Tariff Schedule, searchable. All 35,804 lines of the official USITC schedule across 98 chapters — headings, subheadings and 19,949 ten-digit statistical lines — each with its full duty-rate columns: general (MFN) rate, special FTA program rates (USMCA, Korea, Australia...), the column 2 rate, units of quantity, quota quantities, additional duties and footnotes (including Section 301 references). Every line carries a breadcrumb of its ancestors, so a leaf named simply 'Other' is searchable and meaningful, and full-text search covers descriptions AND that inherited context — searching 'smartphones' finds 8517.13.00.00 (Free), 'portable automatic data processing' finds the laptop line 8471.30.01.00. Look any code up by digits with or without dots (8703.23.01 → passenger vehicles at 2.5% with ancestors and child statistical lines), filter by chapter or code prefix, browse all chapters with WCO section titles. Re-synced nightly from the USITC export, so the ~10-15 yearly HTS revisions reach you at most a day late. The classification backbone for cross-border e-commerce, customs brokers, landed-cost calculators and trade compliance tooling.",
    "contact": {
      "name": "Data and APIs",
      "url": "https://dataandapis.com/contact"
    },
    "termsOfService": "https://dataandapis.com/terms-of-service",
    "license": {
      "name": "Data and APIs Terms of Service",
      "url": "https://dataandapis.com/terms-of-service"
    },
    "x-logo": {
      "url": "https://dataandapis.com/images/tariff-codes.webp"
    }
  },
  "externalDocs": {
    "description": "Documentation, live tester and pricing",
    "url": "https://dataandapis.com/apis/tariff-codes"
  },
  "servers": [
    {
      "url": "https://api-tariff-codes.dataandapis.com"
    }
  ],
  "tags": [
    {
      "name": "Business",
      "description": "Tariff Codes API belongs to the Business category of the Data and APIs catalog."
    }
  ],
  "paths": {
    "/v1/sources": {
      "get": {
        "operationId": "dataSources",
        "summary": "Data Sources",
        "description": "Data Sources endpoint of the Tariff Codes API. Costs 1 token per call.",
        "externalDocs": {
          "url": "https://dataandapis.com/apis/tariff-codes/data-sources"
        },
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "ok": true,
                  "sources": [
                    {
                      "slug": "usitc-hts",
                      "name": "Harmonized Tariff Schedule of the United States",
                      "publisher": "US International Trade Commission",
                      "licence": "US government work (public domain)",
                      "source_url": "https://hts.usitc.gov/",
                      "file_url": "https://hts.usitc.gov/reststop/exportList?from=0101&to=9999&format=JSON&styles=false",
                      "cadence": "revised ~10-15x/year; nightly re-sync",
                      "record_count": 35804,
                      "retrieved_at": "2026-09-06"
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "402": {
            "description": "Subscription past due; the response carries a payment_url"
          },
          "429": {
            "description": "Monthly token allowance exhausted"
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ]
      }
    },
    "/v1/tariffs/chapters": {
      "get": {
        "operationId": "htsChapters",
        "summary": "HTS Chapters",
        "description": "HTS Chapters endpoint of the Tariff Codes API. Costs 1 token per call.",
        "externalDocs": {
          "url": "https://dataandapis.com/apis/tariff-codes/hts-chapters"
        },
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "ok": true,
                  "chapters": 98,
                  "results": [
                    {
                      "chapter": "01",
                      "title": "Live animals",
                      "section": "I - Live animals; animal products",
                      "rows_total": 126,
                      "leaves": 78
                    },
                    {
                      "chapter": "02",
                      "title": "Meat and edible meat offal",
                      "section": "I - Live animals; animal products",
                      "rows_total": 256,
                      "leaves": 166
                    },
                    {
                      "chapter": "03",
                      "title": "Fish, crustaceans, molluscs and other aquatic invertebrates",
                      "section": "I - Live animals; animal products",
                      "rows_total": 797,
                      "leaves": 562
                    },
                    {
                      "chapter": "04",
                      "title": "Dairy produce; birds' eggs; honey",
                      "section": "I - Live animals; animal products",
                      "rows_total": 435,
                      "leaves": 272
                    },
                    {
                      "chapter": "05",
                      "title": "Products of animal origin, nesoi",
                      "section": "I - Live animals; animal products",
                      "rows_total": 61,
                      "leaves": 38
                    },
                    {
                      "chapter": "06",
                      "title": "Live trees and other plants; cut flowers",
                      "section": "II - Vegetable products",
                      "rows_total": 106,
                      "leaves": 78
                    },
                    {
                      "chapter": "07",
                      "title": "Edible vegetables",
                      "section": "II - Vegetable products",
                      "rows_total": 643,
                      "leaves": 422
                    },
                    {
                      "chapter": "08",
                      "title": "Edible fruit and nuts; citrus or melon peel",
                      "section": "II - Vegetable products",
                      "rows_total": 395,
                      "leaves": 240
                    },
                    {
                      "chapter": "09",
                      "title": "Coffee, tea, mate and spices",
                      "section": "II - Vegetable products",
                      "rows_total": 154,
                      "leaves": 91
                    },
                    {
                      "chapter": "10",
                      "title": "Cereals",
                      "section": "II - Vegetable products",
                      "rows_total": 105,
                      "leaves": 66
                    },
                    {
                      "chapter": "11",
                      "title": "Milling products; malt; starches",
                      "section": "II - Vegetable products",
                      "rows_total": 81,
                      "leaves": 51
                    },
                    {
                      "chapter": "12",
                      "title": "Oil seeds; miscellaneous grains, seeds and fruit",
                      "section": "II - Vegetable products",
                      "rows_total": 256,
                      "leaves": 167
                    },
                    {
                      "chapter": "13",
                      "title": "Lac; gums, resins and other vegetable saps",
                      "section": "II - Vegetable products",
                      "rows_total": 37,
                      "leaves": 24
                    },
                    {
                      "chapter": "14",
                      "title": "Vegetable plaiting materials",
                      "section": "II - Vegetable products",
                      "rows_total": 23,
                      "leaves": 14
                    },
                    {
                      "chapter": "15",
                      "title": "Animal or vegetable fats, oils and waxes",
                      "section": "III - Animal or vegetable fats and oils",
                      "rows_total": 188,
                      "leaves": 114
                    },
                    {
                      "chapter": "16",
                      "title": "Preparations of meat, fish or crustaceans",
                      "section": "IV - Prepared foodstuffs; beverages; tobacco",
                      "rows_total": 315,
                      "leaves": 179
                    },
                    {
                      "chapter": "17",
                      "title": "Sugars and sugar confectionery",
                      "section": "IV - Prepared foodstuffs; beverages; tobacco",
                      "rows_total": 157,
                      "leaves": 92
                    },
                    {
                      "chapter": "18",
                      "title": "Cocoa and cocoa preparations",
                      "section": "IV - Prepared foodstuffs; beverages; tobacco",
                      "rows_total": 161,
                      "leaves": 91
                    },
                    {
                      "chapter": "19",
                      "title": "Preparations of cereals, flour, starch or milk",
                      "section": "IV - Prepared foodstuffs; beverages; tobacco",
                      "rows_total": 191,
                      "leaves": 111
                    },
                    {
                      "chapter": "20",
                      "title": "Preparations of vegetables, fruit or nuts",
                      "section": "IV - Prepared foodstuffs; beverages; tobacco",
                      "rows_total": 454,
                      "leaves": 285
                    },
                    {
                      "chapter": "21",
                      "title": "Miscellaneous edible preparations",
                      "section": "IV - Prepared foodstuffs; beverages; tobacco",
                      "rows_total": 193,
                      "leaves": 118
                    },
                    {
                      "chapter": "22",
                      "title": "Beverages, spirits and vinegar",
                      "section": "IV - Prepared foodstuffs; beverages; tobacco",
                      "rows_total": 211,
                      "leaves": 121
                    },
                    {
                      "chapter": "23",
                      "title": "Residues from food industries; animal feed",
                      "section": "IV - Prepared foodstuffs; beverages; tobacco",
                      "rows_total": 92,
                      "leaves": 61
                    },
                    {
                      "chapter": "24",
                      "title": "Tobacco and manufactured tobacco substitutes",
                      "section": "IV - Prepared foodstuffs; beverages; tobacco",
                      "rows_total": 304,
                      "leaves": 205
                    },
                    {
                      "chapter": "25",
                      "title": "Salt; sulphur; earths and stone; lime and cement",
                      "section": "V - Mineral products",
                      "rows_total": 150,
                      "leaves": 101
                    },
                    {
                      "chapter": "26",
                      "title": "Ores, slag and ash",
                      "section": "V - Mineral products",
                      "rows_total": 143,
                      "leaves": 102
                    },
                    {
                      "chapter": "27",
                      "title": "Mineral fuels, oils and waxes",
                      "section": "V - Mineral products",
                      "rows_total": 218,
                      "leaves": 141
                    },
                    {
                      "chapter": "28",
                      "title": "Inorganic chemicals; compounds of precious metals",
                      "section": "VI - Products of the chemical or allied industries",
                      "rows_total": 501,
                      "leaves": 342
                    },
                    {
                      "chapter": "29",
                      "title": "Organic chemicals",
                      "section": "VI - Products of the chemical or allied industries",
                      "rows_total": 1859,
                      "leaves": 1239
                    },
                    {
                      "chapter": "30",
                      "title": "Pharmaceutical products",
                      "section": "VI - Products of the chemical or allied industries",
                      "rows_total": 283,
                      "leaves": 198
                    },
                    {
                      "chapter": "31",
                      "title": "Fertilizers",
                      "section": "VI - Products of the chemical or allied industries",
                      "rows_total": 41,
                      "leaves": 29
                    },
                    {
                      "chapter": "32",
                      "title": "Tanning or dyeing extracts; paints; inks",
                      "section": "VI - Products of the chemical or allied industries",
                      "rows_total": 236,
                      "leaves": 168
                    },
                    {
                      "chapter": "33",
                      "title": "Essential oils; perfumery and cosmetic preparations",
                      "section": "VI - Products of the chemical or allied industries",
                      "rows_total": 104,
                      "leaves": 74
                    },
                    {
                      "chapter": "34",
                      "title": "Soap, waxes, polishes and candles",
                      "section": "VI - Products of the chemical or allied industries",
                      "rows_total": 79,
                      "leaves": 48
                    },
                    {
                      "chapter": "35",
                      "title": "Albuminoidal substances; glues; enzymes",
                      "section": "VI - Products of the chemical or allied industries",
                      "rows_total": 55,
                      "leaves": 33
                    },
                    {
                      "chapter": "36",
                      "title": "Explosives; pyrotechnics; matches",
                      "section": "VI - Products of the chemical or allied industries",
                      "rows_total": 27,
                      "leaves": 19
                    },
                    {
                      "chapter": "37",
                      "title": "Photographic or cinematographic goods",
                      "section": "VI - Products of the chemical or allied industries",
                      "rows_total": 100,
                      "leaves": 61
                    },
                    {
                      "chapter": "38",
                      "title": "Miscellaneous chemical products",
                      "section": "VI - Products of the chemical or allied industries",
                      "rows_total": 331,
                      "leaves": 218
                    },
                    {
                      "chapter": "39",
                      "title": "Plastics and articles thereof",
                      "section": "VII - Plastics and rubber",
                      "rows_total": 502,
                      "leaves": 320
                    },
                    {
                      "chapter": "40",
                      "title": "Rubber and articles thereof",
                      "section": "VII - Plastics and rubber",
                      "rows_total": 319,
                      "leaves": 198
                    },
                    {
                      "chapter": "41",
                      "title": "Raw hides, skins and leather",
                      "section": "VIII - Hides, skins, leather and travel goods",
                      "rows_total": 314,
                      "leaves": 176
                    },
                    {
                      "chapter": "42",
                      "title": "Articles of leather; handbags; travel goods",
                      "section": "VIII - Hides, skins, leather and travel goods",
                      "rows_total": 208,
                      "leaves": 121
                    },
                    {
                      "chapter": "43",
                      "title": "Furskins and artificial fur",
                      "section": "VIII - Hides, skins, leather and travel goods",
                      "rows_total": 56,
                      "leaves": 39
                    },
                    {
                      "chapter": "44",
                      "title": "Wood and articles of wood; wood charcoal",
                      "section": "IX - Wood, cork and articles thereof",
                      "rows_total": 876,
                      "leaves": 556
                    },
                    {
                      "chapter": "45",
                      "title": "Cork and articles of cork",
                      "section": "IX - Wood, cork and articles thereof",
                      "rows_total": 29,
                      "leaves": 19
                    },
                    {
                      "chapter": "46",
                      "title": "Manufactures of straw or other plaiting materials",
                      "section": "IX - Wood, cork and articles thereof",
                      "rows_total": 83,
                      "leaves": 49
                    },
                    {
                      "chapter": "47",
                      "title": "Pulp of wood or other fibrous cellulosic material",
                      "section": "X - Pulp, paper and printed products",
                      "rows_total": 40,
                      "leaves": 26
                    },
                    {
                      "chapter": "48",
                      "title": "Paper and paperboard and articles thereof",
                      "section": "X - Pulp, paper and printed products",
                      "rows_total": 513,
                      "leaves": 312
                    },
                    {
                      "chapter": "49",
                      "title": "Printed books, newspapers and other printed products",
                      "section": "X - Pulp, paper and printed products",
                      "rows_total": 80,
                      "leaves": 50
                    },
                    {
                      "chapter": "50",
                      "title": "Silk",
                      "section": "XI - Textiles and textile articles",
                      "rows_total": 50,
                      "leaves": 30
                    },
                    {
                      "chapter": "51",
                      "title": "Wool and animal hair",
                      "section": "XI - Textiles and textile articles",
                      "rows_total": 209,
                      "leaves": 124
                    },
                    {
                      "chapter": "52",
                      "title": "Cotton",
                      "section": "XI - Textiles and textile articles",
                      "rows_total": 842,
                      "leaves": 525
                    },
                    {
                      "chapter": "53",
                      "title": "Other vegetable textile fibers; paper yarn",
                      "section": "XI - Textiles and textile articles",
                      "rows_total": 96,
                      "leaves": 62
                    },
                    {
                      "chapter": "54",
                      "title": "Man-made filaments",
                      "section": "XI - Textiles and textile articles",
                      "rows_total": 436,
                      "leaves": 265
                    },
                    {
                      "chapter": "55",
                      "title": "Man-made staple fibers",
                      "section": "XI - Textiles and textile articles",
                      "rows_total": 556,
                      "leaves": 399
                    },
                    {
                      "chapter": "56",
                      "title": "Wadding, felt, nonwovens; twine and cordage",
                      "section": "XI - Textiles and textile articles",
                      "rows_total": 133,
                      "leaves": 81
                    },
                    {
                      "chapter": "57",
                      "title": "Carpets and other textile floor coverings",
                      "section": "XI - Textiles and textile articles",
                      "rows_total": 125,
                      "leaves": 74
                    },
                    {
                      "chapter": "58",
                      "title": "Special woven fabrics; lace; tapestries; embroidery",
                      "section": "XI - Textiles and textile articles",
                      "rows_total": 181,
                      "leaves": 111
                    },
                    {
                      "chapter": "59",
                      "title": "Impregnated, coated or laminated textile fabrics",
                      "section": "XI - Textiles and textile articles",
                      "rows_total": 124,
                      "leaves": 75
                    },
                    {
                      "chapter": "60",
                      "title": "Knitted or crocheted fabrics",
                      "section": "XI - Textiles and textile articles",
                      "rows_total": 178,
                      "leaves": 106
                    },
                    {
                      "chapter": "61",
                      "title": "Apparel and clothing accessories, knitted or crocheted",
                      "section": "XI - Textiles and textile articles",
                      "rows_total": 1345,
                      "leaves": 838
                    },
                    {
                      "chapter": "62",
                      "title": "Apparel and clothing accessories, not knitted or crocheted",
                      "section": "XI - Textiles and textile articles",
                      "rows_total": 2089,
                      "leaves": 1248
                    },
                    {
                      "chapter": "63",
                      "title": "Other made up textile articles; rags",
                      "section": "XI - Textiles and textile articles",
                      "rows_total": 377,
                      "leaves": 231
                    },
                    {
                      "chapter": "64",
                      "title": "Footwear, gaiters and the like",
                      "section": "XII - Footwear, headgear, umbrellas",
                      "rows_total": 655,
                      "leaves": 391
                    },
                    {
                      "chapter": "65",
                      "title": "Headgear and parts thereof",
                      "section": "XII - Footwear, headgear, umbrellas",
                      "rows_total": 118,
                      "leaves": 64
                    },
                    {
                      "chapter": "66",
                      "title": "Umbrellas, walking sticks and whips",
                      "section": "XII - Footwear, headgear, umbrellas",
                      "rows_total": 13,
                      "leaves": 8
                    },
                    {
                      "chapter": "67",
                      "title": "Prepared feathers; artificial flowers",
                      "section": "XII - Footwear, headgear, umbrellas",
                      "rows_total": 21,
                      "leaves": 13
                    },
                    {
                      "chapter": "68",
                      "title": "Articles of stone, plaster, cement or asbestos",
                      "section": "XIII - Stone, ceramic and glass articles",
                      "rows_total": 160,
                      "leaves": 98
                    },
                    {
                      "chapter": "69",
                      "title": "Ceramic products",
                      "section": "XIII - Stone, ceramic and glass articles",
                      "rows_total": 211,
                      "leaves": 121
                    },
                    {
                      "chapter": "70",
                      "title": "Glass and glassware",
                      "section": "XIII - Stone, ceramic and glass articles",
                      "rows_total": 481,
                      "leaves": 281
                    },
                    {
                      "chapter": "71",
                      "title": "Pearls, precious stones and metals; jewelry; coin",
                      "section": "XIV - Pearls, precious stones and metals",
                      "rows_total": 240,
                      "leaves": 143
                    },
                    {
                      "chapter": "72",
                      "title": "Iron and steel",
                      "section": "XV - Base metals and articles thereof",
                      "rows_total": 951,
                      "leaves": 562
                    },
                    {
                      "chapter": "73",
                      "title": "Articles of iron or steel",
                      "section": "XV - Base metals and articles thereof",
                      "rows_total": 970,
                      "leaves": 573
                    },
                    {
                      "chapter": "74",
                      "title": "Copper and articles thereof",
                      "section": "XV - Base metals and articles thereof",
                      "rows_total": 238,
                      "leaves": 136
                    },
                    {
                      "chapter": "75",
                      "title": "Nickel and articles thereof",
                      "section": "XV - Base metals and articles thereof",
                      "rows_total": 50,
                      "leaves": 29
                    },
                    {
                      "chapter": "76",
                      "title": "Aluminum and articles thereof",
                      "section": "XV - Base metals and articles thereof",
                      "rows_total": 212,
                      "leaves": 124
                    },
                    {
                      "chapter": "78",
                      "title": "Lead and articles thereof",
                      "section": "XV - Base metals and articles thereof",
                      "rows_total": 21,
                      "leaves": 13
                    },
                    {
                      "chapter": "79",
                      "title": "Zinc and articles thereof",
                      "section": "XV - Base metals and articles thereof",
                      "rows_total": 19,
                      "leaves": 13
                    },
                    {
                      "chapter": "80",
                      "title": "Tin and articles thereof",
                      "section": "XV - Base metals and articles thereof",
                      "rows_total": 17,
                      "leaves": 13
                    },
                    {
                      "chapter": "81",
                      "title": "Other base metals; cermets",
                      "section": "XV - Base metals and articles thereof",
                      "rows_total": 128,
                      "leaves": 84
                    },
                    {
                      "chapter": "82",
                      "title": "Tools, cutlery and tableware of base metal",
                      "section": "XV - Base metals and articles thereof",
                      "rows_total": 304,
                      "leaves": 189
                    },
                    {
                      "chapter": "83",
                      "title": "Miscellaneous articles of base metal",
                      "section": "XV - Base metals and articles thereof",
                      "rows_total": 143,
                      "leaves": 89
                    },
                    {
                      "chapter": "84",
                      "title": "Nuclear reactors, boilers, machinery and mechanical appliances; computers",
                      "section": "XVI - Machinery, electrical equipment and parts",
                      "rows_total": 2699,
                      "leaves": 1706
                    },
                    {
                      "chapter": "85",
                      "title": "Electrical machinery and equipment; sound and TV apparatus",
                      "section": "XVI - Machinery, electrical equipment and parts",
                      "rows_total": 1568,
                      "leaves": 982
                    },
                    {
                      "chapter": "86",
                      "title": "Railway locomotives and rolling stock",
                      "section": "XVII - Vehicles, aircraft, vessels",
                      "rows_total": 56,
                      "leaves": 37
                    },
                    {
                      "chapter": "87",
                      "title": "Vehicles other than railway; parts and accessories",
                      "section": "XVII - Vehicles, aircraft, vessels",
                      "rows_total": 639,
                      "leaves": 402
                    },
                    {
                      "chapter": "88",
                      "title": "Aircraft, spacecraft and parts thereof",
                      "section": "XVII - Vehicles, aircraft, vessels",
                      "rows_total": 113,
                      "leaves": 67
                    },
                    {
                      "chapter": "89",
                      "title": "Ships, boats and floating structures",
                      "section": "XVII - Vehicles, aircraft, vessels",
                      "rows_total": 94,
                      "leaves": 58
                    },
                    {
                      "chapter": "90",
                      "title": "Optical, photographic, measuring and medical instruments",
                      "section": "XVIII - Optical, photographic, medical instruments; clocks",
                      "rows_total": 671,
                      "leaves": 421
                    },
                    {
                      "chapter": "91",
                      "title": "Clocks and watches and parts thereof",
                      "section": "XVIII - Optical, photographic, medical instruments; clocks",
                      "rows_total": 314,
                      "leaves": 177
                    },
                    {
                      "chapter": "92",
                      "title": "Musical instruments and parts thereof",
                      "section": "XVIII - Optical, photographic, medical instruments; clocks",
                      "rows_total": 98,
                      "leaves": 63
                    },
                    {
                      "chapter": "93",
                      "title": "Arms and ammunition and parts thereof",
                      "section": "XIX - Arms and ammunition",
                      "rows_total": 109,
                      "leaves": 67
                    },
                    {
                      "chapter": "94",
                      "title": "Furniture; bedding; lamps; prefabricated buildings",
                      "section": "XX - Miscellaneous manufactured articles",
                      "rows_total": 445,
                      "leaves": 275
                    },
                    {
                      "chapter": "95",
                      "title": "Toys, games and sports equipment",
                      "section": "XX - Miscellaneous manufactured articles",
                      "rows_total": 184,
                      "leaves": 118
                    },
                    {
                      "chapter": "96",
                      "title": "Miscellaneous manufactured articles",
                      "section": "XX - Miscellaneous manufactured articles",
                      "rows_total": 242,
                      "leaves": 157
                    },
                    {
                      "chapter": "97",
                      "title": "Works of art, collectors' pieces and antiques",
                      "section": "XXI - Works of art and antiques",
                      "rows_total": 47,
                      "leaves": 30
                    },
                    {
                      "chapter": "98",
                      "title": "Special classification provisions (US)",
                      "section": "US - Special US classification provisions",
                      "rows_total": 595,
                      "leaves": 492
                    },
                    {
                      "chapter": "99",
                      "title": "Temporary legislation; temporary and additional duties (US)",
                      "section": "US - Special US classification provisions",
                      "rows_total": 3349,
                      "leaves": 3110
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "402": {
            "description": "Subscription past due; the response carries a payment_url"
          },
          "429": {
            "description": "Monthly token allowance exhausted"
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ]
      }
    },
    "/v1/tariffs": {
      "get": {
        "operationId": "searchTariffs",
        "summary": "Search Tariffs",
        "description": "Search Tariffs endpoint of the Tariff Codes API. Costs 1 token per call.",
        "externalDocs": {
          "url": "https://dataandapis.com/apis/tariff-codes/search-tariffs"
        },
        "parameters": [
          {
            "name": "chapter",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "85"
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "leaves_only",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "true"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "25"
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "1"
          },
          {
            "name": "q",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "smartphones"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "ok": true,
                  "page": 1,
                  "limit": 5,
                  "total": 15,
                  "total_pages": 3,
                  "tariffs": [
                    {
                      "seq": 27788,
                      "htsno": "8517.13.00.00",
                      "indent": 2,
                      "description": "Smartphones",
                      "context": "Telephone sets, including smartphones and other telephones for cellular networks or for other wireless networks; other apparatus for the transmission or reception of voice, images or other data, including apparatus for communication in a wired or wireless network (such as a local or wide area network), other than transmission or reception apparatus of heading 8443, 8525, 8527 or 8528; parts thereof > Telephone sets, including smartphones and other telephones for cellular networks or for other wireless networks",
                      "chapter": "85",
                      "is_leaf": true,
                      "units": [
                        "No."
                      ],
                      "general": "Free",
                      "special": null,
                      "other": "35%",
                      "quota_quantity": null,
                      "additional_duties": null,
                      "footnotes": [],
                      "updated_at": "2026-09-06 05:06:09"
                    },
                    {
                      "seq": 27794,
                      "htsno": "8517.18.00.10",
                      "indent": 3,
                      "description": "Videophones",
                      "context": "Telephone sets, including smartphones and other telephones for cellular networks or for other wireless networks; other apparatus for the transmission or reception of voice, images or other data, including apparatus for communication in a wired or wireless network (such as a local or wide area network), other than transmission or reception apparatus of heading 8443, 8525, 8527 or 8528; parts thereof > Telephone sets, including smartphones and other telephones for cellular networks or for other wireless networks > Other",
                      "chapter": "85",
                      "is_leaf": true,
                      "units": [
                        "No."
                      ],
                      "general": null,
                      "special": null,
                      "other": null,
                      "quota_quantity": null,
                      "additional_duties": null,
                      "footnotes": [],
                      "updated_at": "2026-09-06 05:06:09"
                    },
                    {
                      "seq": 27796,
                      "htsno": "8517.18.00.50",
                      "indent": 3,
                      "description": "Other",
                      "context": "Telephone sets, including smartphones and other telephones for cellular networks or for other wireless networks; other apparatus for the transmission or reception of voice, images or other data, including apparatus for communication in a wired or wireless network (such as a local or wide area network), other than transmission or reception apparatus of heading 8443, 8525, 8527 or 8528; parts thereof > Telephone sets, including smartphones and other telephones for cellular networks or for other wireless networks > Other",
                      "chapter": "85",
                      "is_leaf": true,
                      "units": [
                        "No."
                      ],
                      "general": null,
                      "special": null,
                      "other": null,
                      "quota_quantity": null,
                      "additional_duties": null,
                      "footnotes": [],
                      "updated_at": "2026-09-06 05:06:09"
                    },
                    {
                      "seq": 27787,
                      "htsno": "8517.11.00.00",
                      "indent": 2,
                      "description": "Line telephone sets with cordless handsets",
                      "context": "Telephone sets, including smartphones and other telephones for cellular networks or for other wireless networks; other apparatus for the transmission or reception of voice, images or other data, including apparatus for communication in a wired or wireless network (such as a local or wide area network), other than transmission or reception apparatus of heading 8443, 8525, 8527 or 8528; parts thereof > Telephone sets, including smartphones and other telephones for cellular networks or for other wireless networks",
                      "chapter": "85",
                      "is_leaf": true,
                      "units": [
                        "No."
                      ],
                      "general": "Free",
                      "special": null,
                      "other": "35%",
                      "quota_quantity": null,
                      "additional_duties": null,
                      "footnotes": [],
                      "updated_at": "2026-09-06 05:06:09"
                    },
                    {
                      "seq": 27795,
                      "htsno": "8517.18.00.20",
                      "indent": 3,
                      "description": "Multiline telephones (including key, call director and consoles)",
                      "context": "Telephone sets, including smartphones and other telephones for cellular networks or for other wireless networks; other apparatus for the transmission or reception of voice, images or other data, including apparatus for communication in a wired or wireless network (such as a local or wide area network), other than transmission or reception apparatus of heading 8443, 8525, 8527 or 8528; parts thereof > Telephone sets, including smartphones and other telephones for cellular networks or for other wireless networks > Other",
                      "chapter": "85",
                      "is_leaf": true,
                      "units": [
                        "No."
                      ],
                      "general": null,
                      "special": null,
                      "other": null,
                      "quota_quantity": null,
                      "additional_duties": null,
                      "footnotes": [],
                      "updated_at": "2026-09-06 05:06:09"
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "402": {
            "description": "Subscription past due; the response carries a payment_url"
          },
          "429": {
            "description": "Monthly token allowance exhausted"
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ]
      }
    },
    "/v1/tariffs/{code}": {
      "get": {
        "operationId": "tariffLookup",
        "summary": "Tariff Lookup",
        "description": "Tariff Lookup endpoint of the Tariff Codes API. Costs 1 token per call.",
        "externalDocs": {
          "url": "https://dataandapis.com/apis/tariff-codes/tariff-lookup"
        },
        "parameters": [
          {
            "name": "code",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "8703.23.01"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "ok": true,
                  "tariff": {
                    "seq": 28997,
                    "htsno": "8703.23.01",
                    "indent": 2,
                    "description": "Of a cylinder capacity exceeding 1,500 cc but not exceeding 3,000 cc",
                    "context": "Motor cars and other motor vehicles principally designed for the transport of persons (other than those of heading 8702), including station wagons and racing cars > Other vehicles, with only spark-ignition internal combustion piston engines",
                    "chapter": "87",
                    "is_leaf": false,
                    "units": [],
                    "general": "2.5%",
                    "special": "Free (A+,AU,B,BH,CL,CO,D,E,IL,JO,KR,MA,OM, P,PA,PE,S,SG)",
                    "other": "10%",
                    "quota_quantity": null,
                    "additional_duties": null,
                    "footnotes": [
                      {
                        "marker": null,
                        "value": "See 9903.90.08. ",
                        "columns": [
                          "other"
                        ]
                      }
                    ],
                    "updated_at": "2026-09-06 05:06:09"
                  },
                  "ancestors": [
                    {
                      "seq": 28982,
                      "htsno": "8703",
                      "indent": 0,
                      "description": "Motor cars and other motor vehicles principally designed for the transport of persons (other than those of heading 8702), including station wagons and racing cars",
                      "context": null,
                      "chapter": "87",
                      "is_leaf": false,
                      "units": [],
                      "general": null,
                      "special": null,
                      "other": null,
                      "quota_quantity": null,
                      "additional_duties": null,
                      "footnotes": [],
                      "updated_at": "2026-09-06 05:06:09"
                    },
                    {
                      "seq": 28988,
                      "htsno": null,
                      "indent": 1,
                      "description": "Other vehicles, with only spark-ignition internal combustion piston engines",
                      "context": "Motor cars and other motor vehicles principally designed for the transport of persons (other than those of heading 8702), including station wagons and racing cars",
                      "chapter": "87",
                      "is_leaf": false,
                      "units": [],
                      "general": null,
                      "special": null,
                      "other": null,
                      "quota_quantity": null,
                      "additional_duties": null,
                      "footnotes": [],
                      "updated_at": "2026-09-06 05:06:09"
                    }
                  ],
                  "children": [
                    {
                      "seq": 28998,
                      "htsno": "8703.23.01.10",
                      "indent": 3,
                      "description": "Motor homes",
                      "context": "Motor cars and other motor vehicles principally designed for the transport of persons (other than those of heading 8702), including station wagons and racing cars > Other vehicles, with only spark-ignition internal combustion piston engines > Of a cylinder capacity exceeding 1,500 cc but not exceeding 3,000 cc",
                      "chapter": "87",
                      "is_leaf": true,
                      "units": [
                        "No."
                      ],
                      "general": null,
                      "special": null,
                      "other": null,
                      "quota_quantity": null,
                      "additional_duties": null,
                      "footnotes": [],
                      "updated_at": "2026-09-06 05:06:09"
                    },
                    {
                      "seq": 28999,
                      "htsno": null,
                      "indent": 3,
                      "description": "Other",
                      "context": "Motor cars and other motor vehicles principally designed for the transport of persons (other than those of heading 8702), including station wagons and racing cars > Other vehicles, with only spark-ignition internal combustion piston engines > Of a cylinder capacity exceeding 1,500 cc but not exceeding 3,000 cc",
                      "chapter": "87",
                      "is_leaf": false,
                      "units": [],
                      "general": null,
                      "special": null,
                      "other": null,
                      "quota_quantity": null,
                      "additional_duties": null,
                      "footnotes": [],
                      "updated_at": "2026-09-06 05:06:09"
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "402": {
            "description": "Subscription past due; the response carries a payment_url"
          },
          "429": {
            "description": "Monthly token allowance exhausted"
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ]
      }
    }
  },
  "components": {
    "securitySchemes": {
      "ApiKey": {
        "type": "apiKey",
        "in": "header",
        "name": "X-Api-Key",
        "description": "Create a free key at https://dataandapis.com/sign-up. 500 tokens a month on the Free plan; this API costs 1 token per call."
      }
    }
  },
  "security": [
    {
      "ApiKey": []
    }
  ]
}