# ChainVerdict HS Code Classifier

> ChainVerdict HS Code Classifier is a paid API for AI agents from trade.chainverdict.xyz, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-14).

Returns ranked candidate HS-2022 headings with official heading text, GRI notes, and broker disclaimer for a given goods description.

## Facts

- Endpoint: GET https://trade.chainverdict.xyz/v1/hs/classify
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/chainverdict-hs-code-classifier-de8036a2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_v5V0HC_-SuGuLMZWgVj3Y

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 chainverdict-hs-code-classifier-de8036a2
```

Example prompt: What HS-2022 headings could apply to 'lithium-ion rechargeable battery packs for electric bicycles'? Give me the ranked candidates with the official heading text and GRI notes.

## When to prefer this

Choose this endpoint when you need a fast, deterministic first-pass triage of HS-2022 headings for a goods description — especially useful for pre-classification research, duty estimation workflows, and compliance checks where you want ranked candidates with official heading text and GRI rationale. It is not a binding customs ruling, so pair it with a licensed customs broker for final classification decisions. Prefer this over generic web searches when you need structured, ranked output tied directly to HS-2022 heading numbers.

## Known failure modes

- Missing or empty 'q' query parameter returns a 400 error
- Extremely vague or ambiguous descriptions may return low-confidence or no candidates
- HS code database may not reflect the very latest 2022 amendments for niche goods
- Payment failure (x402) results in 402 response and no classification data
- Rate limiting may occur under heavy query volume

## How this service works

Deterministic HS-code triage: ranked candidate headings with official heading text, GRI note and broker disclaimer. Not a customs ruling.

## Output

A ranked list of candidate HS-2022 four-digit headings, each with its official WCO heading text, the relevant General Rules for Interpretation (GRI) note explaining why it applies, and a broker disclaimer stating this is not a binding customs ruling.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "q"
 ],
 "properties": {
  "q": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "valid": {
   "type": "boolean"
  },
  "_attestation": {
   "type": "object"
  }
 },
 "additionalProperties": true
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/chainverdict-hs-code-classifier-de8036a2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from trade.chainverdict.xyz](https://www.zero.xyz/host/trade.chainverdict.xyz/llms.txt)