API service and billing
Registered users can create API keys for three read-only endpoints covering HS codes, products and product–HS links. Each account pays 0.04 USD only for the first successful lookup of each target per endpoint; repeats are free forever. Web and API share packs.
- Availability
- Registered users with a verified email
- Billing
- 0.04 USD
- Deduction order
- Pack → balance
Data you can query
| Capability | Description | Billing |
|---|---|---|
| HS code lookup | Look up an HS code's current version name and import rates, and return its child codes as a tree. | 0.04 USD per record found |
| Product details lookup | Look up basic product details by JAN barcode or product ID, without HS associations. | 0.04 USD per record found |
| Product–HS association lookup | Look up basic product data and confirmed HS associations. | 0.04 USD per record found |
Read-only. All three APIs charge only when a record is found; a missing code or product returns 404 without charge. Insufficient credit returns 402 without partial data.
Authentication
Create an API key in the dashboard and send it via the Authorization header. The full key is shown only once — keep it safe.
Authorization: Bearer mls_xxxxxxxxxxxxxxxx
Full API addresses and request examples are available in the dashboard's API docs.
Every successful response includes the charge for that call (funding, usesCharged, amountCharged, packRemaining, balance, currency).
Billing and usage packs
Web and API share packs and balance. Billable lookups use packs first, then 0.04 USD from balance. Repeat API lookups of the same target on the same endpoint by the same account are free forever, even without credit.
| Usage packs | Available uses | Unit price |
|---|---|---|
| 10.00 USD | 275 | about 0.036 USD / view |
| 50.00 USD | 1,500 | about 0.033 USD / view |
| 100.00 USD | 3,250 | about 0.031 USD / view |
| 500.00 USD | 18,750 | about 0.027 USD / view |
You can also top up the balance and pay 0.04 USD per view. Packs and balance are purchased and reviewed in the dashboard.
Errors and limits
- 402 insufficient_credit: pack uses and balance are both insufficient. Please top up first.
- 404 not_found: the code or product does not exist or is not published.
- 409 ambiguous: the barcode matches multiple products. Query by product ID instead.
- A base limit of 120 requests per hour applies; exceeding it returns 429.
Rates and product–HS associations returned by the API are for reference only. Consult Japanese Customs and the competent authorities for formal classification and clearance.