Corporate registry
Look up a corporate number or search by name prefix in National Tax Agency data. Closed and excluded-from-search records are flagged, and the data version is returned.
MCP + REST API · 13 TOOLS
Holidays, business days, Japanese eras, postal codes, addresses and corporate numbers — as 13 MCP tools and 13 REST endpoints. Every answer carries its source, its reference date and machine-readable flags.
No account or API key required
CAPABILITIES
The same logic for AI agents over MCP and for applications over REST.
Look up a corporate number or search by name prefix in National Tax Agency data. Closed and excluded-from-search records are flagged, and the data version is returned.
Japan Post data: postal code lookup, search by address, and address normalization to town level. It does not verify that a street number exists.
Calculated from the National Holidays Act and checked weekly against the Cabinet Office CSV. Handles substitute holidays and the bank closure (Dec 31 – Jan 3).
Gregorian ↔ wareki conversion from the era start dates, with era-boundary, out-of-era and weekday-mismatch signals.
QUICK START
https://biz.ossalt.jp/mcpAdd this URL to any client that supports remote MCP servers. Connection guide →
curl -fsS 'https://biz.ossalt.jp/v1/holidays?year=2026'All endpoints are GET and return JSON. API reference →
SOURCES
Sources, reference dates and known limits are also returned inside every answer.
| Data | Source | Update |
|---|---|---|
| Corporate numbers | National Tax Agency corporate number publication site, full bulk data (basic 3 items) | Monthly. Imported on the 3rd and 10th. See `data_version` in each answer. |
| Postal codes & addresses | Japan Post postal code data (addresses and business-specific codes) | Imported with the monthly build. See `data_updated` in each answer. |
| Holidays & business days | Calculated from the National Holidays Act, checked against the Cabinet Office CSV | Checked weekly (Mondays). Years after 2027 are not yet checked and carry the `unverified` flag; future equinox dates also carry `estimated`. |
| Japanese eras | Calculated from the era start dates | Updated when an era changes. |
TRUST
Estimates are flagged and anything unverified is labelled as such. Third-party ratings are shown only when verified and dated.
TRY IT
Run a business-day calculation, an era conversion or a corporate number lookup from your browser.