Skip to content

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

Available API endpoints and billing
CapabilityDescriptionBilling
HS code lookupLook 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 lookupLook up basic product details by JAN barcode or product ID, without HS associations.0.04 USD per record found
Product–HS association lookupLook 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.

Pack prices and available uses
Usage packsAvailable usesUnit price
10.00 USD275about 0.036 USD / view
50.00 USD1,500about 0.033 USD / view
100.00 USD3,250about 0.031 USD / view
500.00 USD18,750about 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.