# BRAINIAC HS Code Candidate Suggest

> BRAINIAC HS Code Candidate Suggest is a paid API for AI agents from www.brainiac.software, paid per call via x402, $0.06/call, status unknown (last checked 2026-11-17).

Suggests candidate HS (Harmonized System) tariff codes for a product description or supplied code using the UK Trade Tariff search, returning potential matches with caveats that these are not formal customs classifications.

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/freight-customs/hs-code-candidate-suggest?utm_source=zero.xyz
- Price: $0.06/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-17
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/brainiac-hs-code-candidate-suggest-62e3a5bb
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_FH_g98lF-U5jCfcn2z-7W

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 brainiac-hs-code-candidate-suggest-62e3a5bb -d '<json body>'
```

Example prompt: Can you suggest some HS code candidates for 'cotton t-shirts' — I want to see what UK Trade Tariff codes might apply so I can figure out the right one for my customs paperwork?

## When to prefer this

Use this endpoint when you need a quick, accountless lookup of plausible HS tariff code candidates from the UK Trade Tariff without needing to set up an account or integration. It is best suited for early-stage customs research, pre-classification shortlisting, or validating whether an existing code is in the right ballpark. It is not a replacement for formal customs classification — use it to narrow options before engaging a licensed customs broker or submitting a declaration.

## Known failure modes

- Ambiguous product description returns unrelated or low-relevance candidates
- Very specific or niche product descriptions may return no candidates
- Duty rates, sanctions, and country requirements are always returned as 'unavailable' — this endpoint does not provide those values
- The endpoint explicitly does not submit a customs declaration or book a shipment
- Supplied HS code may not appear in candidates even if it is valid
- Short or overly broad descriptions may return too many generic candidates

## How this service works

Pay-per-call APIs for AI agents: OFAC sanctions screening, compliance checks, token security, and Base chain data via x402. No account. Fixed USDC price. MCP-ready.

## Output

A JSON object containing: a list of HS code candidates from the UK Trade Tariff with their codes and descriptions, the status of the lookup (e.g. 'candidates'), findings about whether the supplied code matches any candidate, the product description used, timestamps, and availability indicators for duty rates, sanctions, restrictions, and country requirements. Includes explicit limitations clarifying these are not formal customs classifications.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "hsCode": {
   "type": "string",
   "maxLength": 14,
   "minLength": 4
  },
  "description": {
   "type": "string",
   "maxLength": 300,
   "minLength": 2
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "duty": "unavailable",
  "source": "UK Trade Tariff",
  "status": "candidates",
  "findings": [
   {
    "code": "candidates_returned",
    "kind": "extracted",
    "detail": "These are search candidates from the UK Trade Tariff. They are not a customs classification."
   },
   {
    "code": "supplied_code_in_candidates",
    "kind": "extracted",
    "detail": "The supplied code matches a returned candidate by prefix. This is not a classification."
   }
  ],
  "checkedAt": "2026-11-02T19:00:00.000Z",
  "sanctions": "unavailable",
  "candidates": [
   {
    "code": "6109100010",
    "source": "UK Trade Tariff",
    "description": "T-shirts"
   },
   {
    "code": "6109100090",
    "source": "UK Trade Tariff",
    "description": "Other"
   },
   "…"
  ],
  "description": "cotton t-shirts",
  "limitations": [
   "No customs declaration was submitted and no shipment was booked.",
   "Duty rates, restrictions, sanctions status, and country-specific requirements are not invented.",
   "…"
  ],
  "restrictions": "unavailable",
  "shipmentBooked": false,
  "countryRequirements": "unavailable",
  "declarationSubmitted": false,
  "definitiveClassification": false
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-hs-code-candidate-suggest-62e3a5bb/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.brainiac.software](https://www.zero.xyz/host/www.brainiac.software/llms.txt)
