# 2s Commodity Code Resolver (HS / HTS / Schedule B)

> 2s Commodity Code Resolver (HS / HTS / Schedule B) is a paid API for AI agents from 2s.io, paid per call via x402, $0.009/call, status unknown (last checked 2026-09-14).

Resolves a commodity trade code across classification systems, returning cross-referenced HS6, HTS, Schedule B, SITC, and NAICS codes with descriptions.

## Facts

- Endpoint: GET https://2s.io/api/trade/commodity-resolve
- Price: $0.009/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/2s-commodity-code-resolver-hs-hts-schedule-b-90d2eea9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_zelK09B62J2kpvwY-5C8q

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 2s-commodity-code-resolver-hs-hts-schedule-b-90d2eea9
```

Example prompt: What are the HTS, Schedule B, SITC, and NAICS codes that map to HS commodity code 090121, and what's the description of that product?

## When to prefer this

Use this endpoint when you need to cross-reference a commodity trade code (HS, HTS, or Schedule B) against other classification systems such as SITC or NAICS, or when you need the official description of a commodity. Ideal for trade compliance, customs documentation, import/export analytics, and supply chain enrichment workflows where ground-truth US Census Bureau concordance data is required.

## Known failure modes

- Invalid or unrecognized commodity code returns empty items array with ok:true and total:0
- Wrong system enum value returns a validation error
- Malformed code with unsupported characters may return no results
- Network or payment failure returns HTTP 402 or connection error

## How this service works

Cross-walk a traded-good code across HS (6-digit international Harmonized System) <-> HTS (US 10-digit import) <-> Schedule B (US 10-digit export) <-> NAICS industry. Pass the system + code and get the shared HS6, the official description, the matching Schedule B and HTS national lines, the NAICS industry(ies), and the SITC code. The join an import/export, customs, or supply-chain agent needs to move between the export schedule, the import tariff schedule, the international HS level, and the industry that makes the good -- all keyed on the globally-harmonized HS6 bridge. Backed by bundled public-domain US Census Foreign Trade concordances (Schedule B + HTS, latest annual). For a 10-digit input the NAICS is narrowed to that exact national line; cross-schedule lines are surfaced via the shared HS6 and flagged in notes. Companion to trade.tariff (duty rates) and business.naics (industry detail).

## Output

Returns an array of matched commodity records, each containing the HS6 code, arrays of HTS codes, Schedule B codes, SITC codes, NAICS codes, a human-readable description of the commodity, and the classification system the result was resolved from. Also includes total count and source attribution (US Census Bureau).

## 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",
    "queryParams"
   ],
   "properties": {
    "type": {
     "const": "http"
    },
    "method": {
     "const": "GET"
    },
    "queryParams": {
     "required": [
      "system",
      "code"
     ],
     "properties": {
      "code": {
       "type": "string",
       "description": "Commodity code, dots optional, e.g. 0901210000."
      },
      "system": {
       "enum": [
        "hs",
        "hts",
        "scheduleb"
       ],
       "type": "string",
       "description": "Which system the code is in."
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/2s-commodity-code-resolver-hs-hts-schedule-b-90d2eea9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 2s.io](https://www.zero.xyz/host/2s.io/llms.txt)