Skip to content

REST API

https://biz.ossalt.jp
  • All 13 endpoints use GET and return application/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-urlencode does 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 a 400. (Before 0.9.1, only the last value was used, without an error.)
  • Cross-origin requests from browsers are allowed (access-control-allow-origin: *).
Terminal window
curl -fsS 'https://biz.ossalt.jp/v1/holidays?year=2026'
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.

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.

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).

PathMCP toolRequiredOptional
GET /v1/holidayslist_holidaysyear—
GET /v1/business-days/checkcheck_business_daydatecalendar, extra_holidays, extra_business_days
GET /v1/business-days/addadd_business_daysdate, dayscalendar, extra_holidays, extra_business_days
GET /v1/business-days/countcount_business_daysstart, endcalendar, extra_holidays, extra_business_days
GET /v1/business-days/adjustadjust_to_business_daydatedirection, calendar, extra_holidays, extra_business_days
GET /v1/business-days/last-of-monthlast_business_day_of_monthyear, monthcalendar, extra_holidays, extra_business_days
GET /v1/japanese-era/to-erato_japanese_eradate—
GET /v1/japanese-era/from-erafrom_japanese_erawareki—
GET /v1/postal-codes/lookuplookup_postal_codepostal_code—
GET /v1/postal-codes/searchsearch_postal_codecityprefecture, town, office_name
GET /v1/addresses/normalizenormalize_addressaddress—
GET /v1/corporations/lookuplookup_corporate_numbercorporate_number—
GET /v1/corporations/searchsearch_corporation_by_namenameprefecture
GET /v1/holidays — List Japanese national holidays
ParameterTypeRequiredDescription
yearintegerrequiredYear (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
ParameterTypeRequiredDescription
datestringrequiredDate (YYYY-MM-DD)
calendarstringoptional"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_holidaysstringoptionalAdditional company-specific closed days (e.g. summer break).
extra_business_daysstringoptionalDays 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営業日後・前
ParameterTypeRequiredDescription
datestringrequiredStart date (YYYY-MM-DD)
daysintegerrequiredNumber of business days (negative = before)
range: -2000 – 2000
calendarstringoptional"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_holidaysstringoptionalAdditional company-specific closed days (e.g. summer break).
extra_business_daysstringoptionalDays 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
ParameterTypeRequiredDescription
startstringrequiredStart date (YYYY-MM-DD)
endstringrequiredEnd date (YYYY-MM-DD)
calendarstringoptional"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_holidaysstringoptionalAdditional company-specific closed days (e.g. summer break).
extra_business_daysstringoptionalDays 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
ParameterTypeRequiredDescription
datestringrequiredDate (YYYY-MM-DD)
directionstringoptionalnext = 後ろ倒し, previous = 前倒し
values: next | previous
calendarstringoptional"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_holidaysstringoptionalAdditional company-specific closed days (e.g. summer break).
extra_business_daysstringoptionalDays 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
ParameterTypeRequiredDescription
yearintegerrequiredYear (1980-2099)
range: 1980 – 2099
monthintegerrequiredMonth (1-12)
range: 1 – 12
calendarstringoptional"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_holidaysstringoptionalAdditional company-specific closed days (e.g. summer break).
extra_business_daysstringoptionalDays 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)
ParameterTypeRequiredDescription
datestringrequiredDate (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
ParameterTypeRequiredDescription
warekistringrequiredJapanese 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
ParameterTypeRequiredDescription
postal_codestringrequired7-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
ParameterTypeRequiredDescription
prefecturestringoptionalPrefecture, e.g. 東京都 (optional)
citystringrequiredMunicipality, e.g. 新宿区
townstringoptionalPart of the town name, e.g. 西新宿 (optional)
office_namestringoptionalPart 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)
ParameterTypeRequiredDescription
addressstringrequiredJapanese 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
ParameterTypeRequiredDescription
corporate_numberstringrequired13-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
ParameterTypeRequiredDescription
namestringrequiredBeginning of the corporate name (e.g. トヨタ自動車)
prefecturestringoptionalPrefecture 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