Japan Customs exchange rate lookup
jp_customs_fxRead-only
Which JPY rate did Japan Customs publish for this currency on this date? Input: ISO 4217 code and YYYY-MM-DD date. Returns status (valid/invalid/unknown), the inclusive effective period, the JPY rate as published with its base units (1 or 100), source URLs, retrieval and verification times and SHA-256 hashes. Dates from 2021-08-15. Unpublished periods and unlisted currencies return unknown. Reference for customs and bookkeeping only; not a market or remittance rate; no tax calculation.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| date | Yes | Calendar date YYYY-MM-DD (Japan), e.g. 2026-10-07 | |
| currency | Yes | Uppercase ISO 4217 alpha-3 code, e.g. USD |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| rate | Yes | ||
| query | Yes | ||
| terms | Yes | URL of the terms of service. | |
| notice | Yes | ||
| reason | Yes | ||
| status | Yes | valid = published rate found; invalid = malformed input; unknown = could not be confirmed from the checked sources. | |
| sources | Yes | ||
| answered_at | Yes | ||
| dataset_version | Yes | ||
| effective_period | Yes | Inclusive effective period of the rate (YYYY-MM-DD). |