# SiteCheck Trade & Energy – Japan Customs Tariff Lookup

> SiteCheck Trade & Energy – Japan Customs Tariff Lookup is a paid API for AI agents from api.tradeenergy-api.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-29).

Returns Japan Customs import tariff lines for a given HS heading or subheading from the official 2026-04-01 schedule, including description, general rate, temporary rate, WTO rate, and unit.

## Facts

- Endpoint: GET https://api.tradeenergy-api.workers.dev/api/logistics/japan-customs-tariff?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sitecheck-trade-energy-japan-customs-tariff-lookup-7eb3a87e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_K2pXm3TWRH97HPYIoOnAY

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 sitecheck-trade-energy-japan-customs-tariff-lookup-7eb3a87e
```

Example prompt: What is Japan's 2026 import tariff rate for HS subheading 8703.21? I need the general rate, WTO rate, and unit of measure.

## When to prefer this

Use this endpoint when you need machine-readable Japan import tariff rates for a specific HS heading or subheading from the official 2026-04-01 Japan Customs schedule, especially when you need general, temporary, and WTO rates in one call. Prefer this over manual scraping of customs.go.jp when building trade compliance tools, landed cost calculators, or customs classification workflows targeting the Japanese market.

## Known failure modes

- Invalid or malformed HS code returns an error or empty lines array
- HS heading not found in the 2026 schedule returns zero lines
- Source page encoding issues (Shift_JIS decoding failure) may cause garbled descriptions
- Upstream customs.go.jp page unavailability causes fetch failure
- Requesting a chapter not covered by the English schedule may return no data

## How this service works

Japan Customs import tariff lines for an HS heading or subheading (e.g. 8703 or 8703.21) from the official chapter table: description, general tariff rate, temporary rate, WTO rate and unit. Only the English chapter page for the 2026-04-01 schedule is used; the chapter table is decoded from Shift_JIS.

## Output

A JSON object containing the queried HS code, a count of matching tariff lines, and an array of lines each with HS subheading, statistical code, description, general tariff rate, temporary rate (if any), WTO rate (if any), and unit of measure, plus the source URL on customs.go.jp and the timestamp of the check.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "hs"
     ],
     "properties": {
      "hs": {
       "type": "string",
       "description": "HS heading (4 digits) or subheading (6 digits, dot optional), e.g. 8703 or 870321"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "hs": "8703.21",
  "count": 1,
  "lines": [
   {
    "hs": "8703.21",
    "unit": "(Free)",
    "statCode": "000",
    "description": "Of a cylinder capacity not exceeding 1,000 cc",
    "generalRate": "Free"
   }
  ],
  "source": "https://www.customs.go.jp/english/tariff/2026_04_01/data/e_87.htm",
  "checkedAt": "2026-10-23T09:38:02.330Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sitecheck-trade-energy-japan-customs-tariff-lookup-7eb3a87e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.tradeenergy-api.workers.dev](https://www.zero.xyz/host/api.tradeenergy-api.workers.dev/llms.txt)