REST API
Basics
Section titled “Basics”https://biz.ossalt.jp- All 13 endpoints use
GETand returnapplication/json. There is no authentication. - Every successful answer has the same five fields as the MCP tools.
- Send text values URL-encoded. With curl,
-G --data-urlencodedoes it for you. - List parameters (such as
extra_holidays) take comma-separated values (extra_holidays=2026-08-12,2026-08-13) or a repeated name (extra_holidays=2026-08-12&extra_holidays=2026-08-13); both give the same result. Repeating any other parameter is a400. (Before 0.9.1, only the last value was used, without an error.) - Cross-origin requests from browsers are allowed (
access-control-allow-origin: *).
curl -fsS 'https://biz.ossalt.jp/v1/holidays?year=2026'Errors
Section titled “Errors”| HTTP status | When | Body |
|---|---|---|
400 |
Missing, malformed or out-of-range input | {"error": "…", "type": "invalid_input"} (the message is Japanese text) |
404 |
Unknown path | {"error": "見つかりません", "type": "not_found"} |
405 |
A method other than GET |
{"error": "…", "type": "method_not_allowed"} |
429 |
Too many requests | {"error": "…", "type": "rate_limited"} |
503 |
The server or its data is unavailable | {"error": "…", "type": "server_error"} |
Check the status code and flags: an HTTP 200 can still carry estimated, unverified or not_found. type is one of invalid_input, server_error, rate_limited, not_found and method_not_allowed; the OpenAPI Error schema lists them all.
Limits
Section titled “Limits”Requests are limited per client IP address to about 60 per minute (approximate, counted per Cloudflare location). There is no API key and no per-customer quota, and there is no uptime guarantee. The text fields are limited to 200 characters.
Endpoints
Section titled “Endpoints”Open an endpoint for its parameters and a ready-to-run example. For an interactive view, use the API reference or the Playground.
Generated from the live OpenAPI definition (captured 2026-11-17, version 0.9.1).
| Path | MCP tool | Required | Optional |
|---|---|---|---|
GET /v1/holidays | list_holidays | year | — |
GET /v1/business-days/check | check_business_day | date | calendar, extra_holidays, extra_business_days |
GET /v1/business-days/add | add_business_days | date, days | calendar, extra_holidays, extra_business_days |
GET /v1/business-days/count | count_business_days | start, end | calendar, extra_holidays, extra_business_days |
GET /v1/business-days/adjust | adjust_to_business_day | date | direction, calendar, extra_holidays, extra_business_days |
GET /v1/business-days/last-of-month | last_business_day_of_month | year, month | calendar, extra_holidays, extra_business_days |
GET /v1/japanese-era/to-era | to_japanese_era | date | — |
GET /v1/japanese-era/from-era | from_japanese_era | wareki | — |
GET /v1/postal-codes/lookup | lookup_postal_code | postal_code | — |
GET /v1/postal-codes/search | search_postal_code | city | prefecture, town, office_name |
GET /v1/addresses/normalize | normalize_address | address | — |
GET /v1/corporations/lookup | lookup_corporate_number | corporate_number | — |
GET /v1/corporations/search | search_corporation_by_name | name | prefecture |
GET /v1/holidays — List Japanese national holidays
| Parameter | Type | Required | Description |
|---|---|---|---|
year | integer | required | Year (1980-2099) range: 1980 – 2099 |
Example
curl -fsS -G 'https://biz.ossalt.jp/v1/holidays' \
--data-urlencode 'year=2026'HTTP statuses: 200, 400, 429, 503
GET /v1/business-days/check — Check a business day
| Parameter | Type | Required | Description |
|---|---|---|---|
date | string | required | Date (YYYY-MM-DD) |
calendar | string | optional | "standard": weekends and national holidays are closed. "bank": also closed Dec 31 - Jan 3 (Japanese bank holidays). / standard:土日・祝日が休み。bank:加えて12月31日〜1月3日が休み(銀行の休業日) values: standard | bank |
extra_holidays | string | optional | Additional company-specific closed days (e.g. summer break). |
extra_business_days | string | optional | Days treated as business days even if they are weekends or holidays. |
Example
curl -fsS -G 'https://biz.ossalt.jp/v1/business-days/check' \
--data-urlencode 'date=2026-12-31' \
--data-urlencode 'calendar=bank'HTTP statuses: 200, 400, 429, 503
GET /v1/business-days/add — Add business days / n営業日後・前
| Parameter | Type | Required | Description |
|---|---|---|---|
date | string | required | Start date (YYYY-MM-DD) |
days | integer | required | Number of business days (negative = before) range: -2000 – 2000 |
calendar | string | optional | "standard": weekends and national holidays are closed. "bank": also closed Dec 31 - Jan 3 (Japanese bank holidays). / standard:土日・祝日が休み。bank:加えて12月31日〜1月3日が休み(銀行の休業日) values: standard | bank |
extra_holidays | string | optional | Additional company-specific closed days (e.g. summer break). |
extra_business_days | string | optional | Days treated as business days even if they are weekends or holidays. |
Example
curl -fsS -G 'https://biz.ossalt.jp/v1/business-days/add' \
--data-urlencode 'date=2026-11-17' \
--data-urlencode 'days=5'HTTP statuses: 200, 400, 429, 503
GET /v1/business-days/count — Count business days
| Parameter | Type | Required | Description |
|---|---|---|---|
start | string | required | Start date (YYYY-MM-DD) |
end | string | required | End date (YYYY-MM-DD) |
calendar | string | optional | "standard": weekends and national holidays are closed. "bank": also closed Dec 31 - Jan 3 (Japanese bank holidays). / standard:土日・祝日が休み。bank:加えて12月31日〜1月3日が休み(銀行の休業日) values: standard | bank |
extra_holidays | string | optional | Additional company-specific closed days (e.g. summer break). |
extra_business_days | string | optional | Days treated as business days even if they are weekends or holidays. |
Example
curl -fsS -G 'https://biz.ossalt.jp/v1/business-days/count' \
--data-urlencode 'start=2026-12-01' \
--data-urlencode 'end=2026-12-31'HTTP statuses: 200, 400, 429, 503
GET /v1/business-days/adjust — Adjust to a business day
| Parameter | Type | Required | Description |
|---|---|---|---|
date | string | required | Date (YYYY-MM-DD) |
direction | string | optional | next = 後ろ倒し, previous = 前倒し values: next | previous |
calendar | string | optional | "standard": weekends and national holidays are closed. "bank": also closed Dec 31 - Jan 3 (Japanese bank holidays). / standard:土日・祝日が休み。bank:加えて12月31日〜1月3日が休み(銀行の休業日) values: standard | bank |
extra_holidays | string | optional | Additional company-specific closed days (e.g. summer break). |
extra_business_days | string | optional | Days treated as business days even if they are weekends or holidays. |
Example
curl -fsS -G 'https://biz.ossalt.jp/v1/business-days/adjust' \
--data-urlencode 'date=2026-11-23' \
--data-urlencode 'direction=next'HTTP statuses: 200, 400, 429, 503
GET /v1/business-days/last-of-month — Last business day of a month
| Parameter | Type | Required | Description |
|---|---|---|---|
year | integer | required | Year (1980-2099) range: 1980 – 2099 |
month | integer | required | Month (1-12) range: 1 – 12 |
calendar | string | optional | "standard": weekends and national holidays are closed. "bank": also closed Dec 31 - Jan 3 (Japanese bank holidays). / standard:土日・祝日が休み。bank:加えて12月31日〜1月3日が休み(銀行の休業日) values: standard | bank |
extra_holidays | string | optional | Additional company-specific closed days (e.g. summer break). |
extra_business_days | string | optional | Days treated as business days even if they are weekends or holidays. |
Example
curl -fsS -G 'https://biz.ossalt.jp/v1/business-days/last-of-month' \
--data-urlencode 'year=2026' \
--data-urlencode 'month=12' \
--data-urlencode 'calendar=bank'HTTP statuses: 200, 400, 429, 503
GET /v1/japanese-era/to-era — Convert a date to the Japanese era (wareki)
| Parameter | Type | Required | Description |
|---|---|---|---|
date | string | required | Date (YYYY-MM-DD) |
Example
curl -fsS -G 'https://biz.ossalt.jp/v1/japanese-era/to-era' \
--data-urlencode 'date=2019-05-01'HTTP statuses: 200, 400, 429, 503
GET /v1/japanese-era/from-era — Convert a Japanese era date (wareki) to a Gregorian date
| Parameter | Type | Required | Description |
|---|---|---|---|
wareki | string | required | Japanese era date, e.g. 令和8年10月7日 or R8.10.7 |
Example
curl -fsS -G 'https://biz.ossalt.jp/v1/japanese-era/from-era' \
--data-urlencode 'wareki=令和元年5月1日'HTTP statuses: 200, 400, 429, 503
GET /v1/postal-codes/lookup — Look up a Japanese postal code
| Parameter | Type | Required | Description |
|---|---|---|---|
postal_code | string | required | 7-digit postal code, hyphen optional |
Example
curl -fsS -G 'https://biz.ossalt.jp/v1/postal-codes/lookup' \
--data-urlencode 'postal_code=1000001'HTTP statuses: 200, 400, 429, 503
GET /v1/postal-codes/search — Find postal codes by address
| Parameter | Type | Required | Description |
|---|---|---|---|
prefecture | string | optional | Prefecture, e.g. 東京都 (optional) |
city | string | required | Municipality, e.g. 新宿区 |
town | string | optional | Part of the town name, e.g. 西新宿 (optional) |
office_name | string | optional | Part of a business name, in kanji or katakana (optional) |
Example
curl -fsS -G 'https://biz.ossalt.jp/v1/postal-codes/search' \
--data-urlencode 'prefecture=東京都' \
--data-urlencode 'city=千代田区' \
--data-urlencode 'town=千代田'HTTP statuses: 200, 400, 429, 503
GET /v1/addresses/normalize — Normalize a Japanese address (to town level)
| Parameter | Type | Required | Description |
|---|---|---|---|
address | string | required | Japanese address, e.g. 北海道札幌市中央区大通西10丁目1-1 |
Example
curl -fsS -G 'https://biz.ossalt.jp/v1/addresses/normalize' \
--data-urlencode 'address=東京都千代田区千代田1-1'HTTP statuses: 200, 400, 429, 503
GET /v1/corporations/lookup — Look up a Japanese corporate number
| Parameter | Type | Required | Description |
|---|---|---|---|
corporate_number | string | required | 13-digit corporate number, hyphens/spaces allowed |
Example
curl -fsS -G 'https://biz.ossalt.jp/v1/corporations/lookup' \
--data-urlencode 'corporate_number=1000013050238'HTTP statuses: 200, 400, 429, 503
GET /v1/corporations/search — Find corporate numbers by name
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | required | Beginning of the corporate name (e.g. トヨタ自動車) |
prefecture | string | optional | Prefecture to narrow down (optional, e.g. 東京都 or 東京) |
Example
curl -fsS -G 'https://biz.ossalt.jp/v1/corporations/search' \
--data-urlencode 'name=鳥取簡易裁判所' \
--data-urlencode 'prefecture=鳥取県'HTTP statuses: 200, 400, 429, 503
Operated by Momonga