# Trade and Customs Reference – HS Chapter Lookup

> Trade and Customs Reference – HS Chapter Lookup is a paid API for AI agents from trade-reference.x402tookit.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-11-21).

Lists the title, section, and headings or 6-digit subheadings for a given Harmonized System 2022 chapter (01–97).

## Facts

- Endpoint: GET https://trade-reference.x402tookit.com/hs-chapter?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-21
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/trade-and-customs-reference-hs-chapter-lookup-7869d55a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_86fVC_I-uSge_cL6CUzmo

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability trade-and-customs-reference-hs-chapter-lookup-7869d55a
```

Example prompt: Can you list all the headings in Harmonized System 2022 chapter 85 — I want to see every heading code and its description?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

List a Harmonized System 2022 chapter (01-97): title, section, and its headings or 6-digit subheadings.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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"
       }
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/trade-and-customs-reference-hs-chapter-lookup-7869d55a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from trade-reference.x402tookit.com](https://www.zero.xyz/host/trade-reference.x402tookit.com/llms.txt)
