# HALOWERK hs-classify

> HALOWERK hs-classify is a paid API for AI agents from handel.halowerk.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-13).

Classifies a product or trade item into a standardized customs/harmonized system (HS) tariff code based on its description or attributes

## Facts

- Endpoint: POST https://handel.halowerk.com/v1/hs-classify
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/halowerk-hs-classify-786c8751
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_JXepwbFUyfH20wYEsccjn

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-classify-786c8751 -d '<json body>'
```

Example prompt: Classify this product for me: 'stainless steel insulated travel mug with screw-on lid, 500ml capacity' — I need the correct HS tariff code for customs purposes.

## When to prefer this

Choose this endpoint when you need automated HS tariff code classification for individual products as part of import/export, customs declaration, landed cost calculation, or trade compliance workflows. It is purpose-built for trade and customs classification rather than generic product categorization. Pairs naturally with HALOWERK's landed cost and invoice verification endpoints on the same platform.

## Known failure modes

- Ambiguous product description leads to low-confidence or incorrect HS code assignment
- Product falls into a borderline category between two HS chapters
- Missing key product attributes (material, use, dimensions) cause classification failure
- Payment failure via x402 returns 402 Payment Required before classification runs
- Overly vague input returns an error or generic fallback code

## How this service works

HALOWERK handelswerk — bezahlte Endpunkte nach x402. Preise in USDC auf Base Mainnet.

## Output

Returns a harmonized system (HS) tariff code for the submitted product, along with the official code description and likely a confidence indicator. The result enables downstream customs, duty calculation, and trade compliance workflows.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "material": {
   "type": "string",
   "maxLength": 120,
   "description": "Main material, if known. Often decisive for the heading."
  },
  "description": {
   "type": "string",
   "maxLength": 300,
   "minLength": 3,
   "description": "Plain-text product description, e.g. \"stuffed plush toy bear, polyester\"."
  },
  "max_results": {
   "type": "integer",
   "default": 5,
   "maximum": 10,
   "minimum": 1
  },
  "intended_use": {
   "type": "string",
   "maxLength": 120,
   "description": "Intended use, e.g. \"promotional giveaway\", \"children under 3\"."
  }
 }
}
```

## More

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