# Netzhandwerker HS Classify

> Netzhandwerker HS Classify is a paid API for AI agents from tools.netzhandwerker.de, paid per call via x402, $0.004/call, status unknown (last checked 2026-10-09).

Classifies a product description into its Harmonized System (HS) tariff code using the WCO HS6 nomenclature

## Facts

- Endpoint: POST https://tools.netzhandwerker.de/v1/hs/classify?utm_source=zero.xyz
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-09
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/netzhandwerker-hs-classify-91a8280b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Z-Tt02x84UolW1NeBf02B

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 netzhandwerker-hs-classify-91a8280b -d '<json body>'
```

Example prompt: Can you look up the HS tariff code for new bicycle tyres made of rubber — give me the top 5 matches and restrict the search to chapter 40?

## When to prefer this

Use this endpoint when you need fast, automated HS6 tariff code classification for a product based on a natural-language description. It is well-suited for e-commerce customs automation, procurement compliance, and logistics workflows where you need a ranked list of candidate codes with confidence scores. Prefer this over generic search tools when the user specifically needs WCO HS6 nomenclature output with structured chapter and heading metadata. Not a substitute for a legally binding customs ruling.

## Known failure modes

- Vague or ambiguous product description yields low confidence scores and many candidate codes
- Specifying an incorrect chapter filter may exclude the correct code from results
- Description exceeding 1000 characters is rejected
- If limit exceeds 15, the request is rejected
- Non-existent or malformed chapter code may return empty candidates
- Confidence below threshold may indicate the product requires a binding customs ruling

## How this service works

x402-Werkzeuge für autonome Agenten.

## Output

Returns the best-matching HS6 code with chapter, heading, formatted code string, description, matched terms, and a confidence score (0–1). Also returns a list of candidate codes, the number of HS codes searched, query terms used, chapters touched, a note that only binding customs rulings are legally authoritative, and a flag indicating whether a binding ruling is recommended.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "default": 5,
   "maximum": 15
  },
  "chapter": {
   "type": "string",
   "description": "Auf ein Kapitel einschraenken, zweistellig"
  },
  "description": {
   "type": "string",
   "maxLength": 1000,
   "description": "Warenbezeichnung mit Werkstoff, Funktion und Verarbeitungsstufe"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "best": {
   "hs6": "401150",
   "score": 1,
   "chapter": {
    "code": "40",
    "description": "Rubber and articles thereof"
   },
   "heading": {
    "code": "4011",
    "description": "Rubber; new pneumatic tyres"
   },
   "formatted": "40.11.50",
   "description": "Rubber; new pneumatic tyres, of a kind used on bicycles",
   "matched_terms": [
    "tyres",
    "bicycles",
    "rubber",
    "new"
   ]
  },
  "note": "Verbindlich ist allein eine verbindliche Zolltarifauskunft der zustaendigen Zollverwaltung.",
  "caveats": [],
  "candidates": [],
  "confidence": 0.77,
  "description": "Fahrradreifen aus Gummi, neu, fuer Rennraeder",
  "query_terms": [
   "bicycles",
   "tyres",
   "rubber",
   "new"
  ],
  "nomenclature": {
   "codes": 6940,
   "level": "hs6",
   "system": "HS 6-Steller, Weltzollorganisation",
   "language": "en"
  },
  "candidate_count": 5,
  "chapters_touched": [
   "40",
   "87"
  ],
  "requires_binding_ruling": false
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/netzhandwerker-hs-classify-91a8280b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from tools.netzhandwerker.de](https://www.zero.xyz/host/tools.netzhandwerker.de/llms.txt)