# Halowerk HS Code Classifier

> Halowerk HS Code Classifier is a paid API for AI agents from tools.halowerk.com, paid per call via x402, $0.004/call, status unknown (last checked 2026-10-12).

Classifies a German-language goods description into its 6-digit Harmonized System (HS) customs tariff code, returning chapter, heading, subheading, match terms, and confidence score

## Facts

- Endpoint: POST https://tools.halowerk.com/v1/hs/classify?utm_source=zero.xyz
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/halowerk-hs-code-classifier-eb6f2c26
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_R5VcXGyi0M0b5J5e2CxQs

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 halowerk-hs-code-classifier-eb6f2c26 -d '<json body>'
```

Example prompt: Can you find the HS code for 'Fahrradhelm mit integrierter LED-Beleuchtung' — I need the 6-digit Harmonized System code including chapter, heading, and subheading, plus any flags if the result needs a binding customs ruling.

## When to prefer this

Choose this endpoint when you need automated HS code classification specifically for German-language product descriptions within the WCO Harmonized System (6-digit level), especially when you need confidence scoring and explicit flagging of cases that require a binding customs tariff ruling. It is particularly suited for German-speaking trade, logistics, and e-commerce workflows where compound German product names must be parsed correctly.

## Known failure modes

- Ambiguous or vague goods description may return multiple low-confidence proposals
- Highly specialized compound German words not in the vocabulary may yield no matches
- Very broad product categories may return chapter-level results without subheading resolution
- Non-German input may not be understood correctly by the domain vocabulary
- Edge cases at HS chapter boundaries may be flagged as requiring binding ruling rather than resolved automatically

## How this service works

Ordnet eine Warenbeschreibung der sechsstelligen Harmonisierten Nomenklatur der Weltzollorganisation zu, 6.940 Positionen. Versteht deutsche Warenbezeichnungen einschliesslich zusammengesetzter Woerter ueber einen Fachwortschatz und liefert je Vorschlag Kapitel, Position, Unterposition, Trefferbegriffe und einen Wert. Weist die Grenzen der Automatik aus und markiert Faelle fuer die verbindliche Zolltarifauskunft.

## Output

Returns one or more HS code proposals, each containing the WCO chapter, 6-digit heading/subheading, matched vocabulary terms, and a confidence value. Also flags whether the automatic classification reaches its limits and whether a binding customs tariff ruling (verbindliche Zolltarifauskunft) is recommended for the case.

## 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"
  }
 }
}
```

## More

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