{"uid":"cap_86fVC_I-uSge_cL6CUzmo","slug":"trade-and-customs-reference-hs-chapter-lookup-7869d55a","name":"Trade and Customs Reference – HS Chapter Lookup","description":"List a Harmonized System 2022 chapter (01-97): title, section, and its headings or 6-digit subheadings.","url":"https://trade-reference.x402tookit.com/hs-chapter?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["chapter"],"properties":{"limit":{"type":"integer","description":"Rows 1 to 300 (default 100)"},"detail":{"type":"string","description":"headings (default) or subheadings"},"offset":{"type":"integer","description":"Rows to skip (default 0)"},"chapter":{"type":"string","description":"Chapter number 01 to 97, e.g. 85 (chapter 77 is reserved)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"asOf":{"type":["null","string"]},"input":{"type":["null","string"]},"lines":{"type":["array","null"],"items":{"type":"object","properties":{"code":{"type":["null","string"]},"level":{"type":["null","string"]},"formatted":{"type":["null","string"]},"description":{"type":["null","string"]}}}},"title":{"type":["null","string"]},"detail":{"type":["null","string"]},"offset":{"type":["null","number"]},"source":{"type":["null","string"]},"chapter":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"section":{"type":["null","object"],"properties":{"name":{"type":["null","string"]},"roman":{"type":["null","string"]}}},"summary":{"type":["null","string"]},"verdict":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"returned":{"type":["null","number"]},"truncated":{"type":["boolean","null"]},"disclaimer":{"type":["null","string"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"attribution":{"type":["null","string"]},"headingCount":{"type":["null","number"]},"subheadingCount":{"type":["null","number"]}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_C9jOfVtEZVyi0aIEmhOFG","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Lists the title, section, and headings or 6-digit subheadings for a given Harmonized System 2022 chapter (01–97).","exampleAgentPrompt":"Can you list all the headings in Harmonized System 2022 chapter 85 — I want to see every heading code and its description?","exampleUseCases":[{"title":"Classify electronics for import","prompt":"Show me all the headings in HS chapter 85 so I can figure out which one covers the wireless Bluetooth headphones I'm importing."},{"title":"Audit pharmaceutical tariff codes","prompt":"List all 6-digit subheadings for HS chapter 30 — I need to check which subheading our pharmaceutical products fall under for customs clearance."},{"title":"Build HS code reference tool","prompt":"Retrieve the title, section, and first 100 headings for HS chapter 39 (plastics) so I can populate my tariff classification reference database."}],"resultDescription":"Returns the chapter title, its parent section (name and Roman numeral), a paginated list of heading or 6-digit subheading lines (each with code, level, formatted display, and description), total counts of headings and subheadings, pagination metadata (offset, returned, truncated flag), data source attribution, and an 'asOf' timestamp.","failureModes":["Invalid chapter number (outside 01–97 or reserved chapter 77) returns an error or empty result","Unrecognized 'detail' parameter value may default to headings silently","Pagination offset beyond available rows returns empty lines array","Rate limiting or payment failure (402) if USDC payment not attached","Degraded mode flag set if upstream data source is partially unavailable"],"whenToPreferThis":"Choose this endpoint when you need to enumerate all headings or subheadings within a specific HS chapter, browse the hierarchical structure of the Harmonized System 2022, or build a tariff code reference. It is ideal for classification research, customs compliance workflows, and populating trade databases. Prefer it over general HS search endpoints when you already know the chapter and want a structured list rather than a keyword search result.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-21T18:30:30.755Z","isFirstParty":false,"canonicalSlug":"trade-and-customs-reference-hs-chapter-lookup-7869d55a"}