本文へ移動

REST API

https://biz.ossalt.jp
  • 13のエンドポイントはすべて GET で、application/json を返します。認証はありません。
  • 成功した答えは、MCPのツールと同じ5つの項目を持ちます。
  • 文字列の値は、URLエンコードして送ります。curl なら -G --data-urlencode が自動でしてくれます。
  • リストの項目(extra_holidays など)は、カンマ区切り(extra_holidays=2026-08-12,2026-08-13)でも、同じ名前の繰り返し(extra_holidays=2026-08-12&extra_holidays=2026-08-13)でも、同じ結果になります。そのほかの項目を繰り返すと 400 です(0.9.0 までは、エラーにならずに、最後の値だけが使われていました)。
  • ブラウザからの別オリジンの呼び出しは許可しています(access-control-allow-origin: *)。
ターミナルウィンドウ
curl -fsS 'https://biz.ossalt.jp/v1/holidays?year=2026'
HTTPの状態 いつ 本文
400 入力がない・形が違う・範囲の外 {"error": "…", "type": "invalid_input"}(文は日本語)
404 知らない道筋 {"error": "見つかりません", "type": "not_found"}
405 GET 以外のメソッド {"error": "…", "type": "method_not_allowed"}
429 呼び出しが多すぎる {"error": "…", "type": "rate_limited"}
503 サーバーやデータが使えない {"error": "…", "type": "server_error"}

状態コードと flags の両方を確かめてください。HTTP 200 でも、estimated・unverified・not_found が付くことがあります。type は、invalid_input・server_error・rate_limited・not_found・method_not_allowed のどれかで、OpenAPIの Error スキーマに、すべて載っています。

呼び出しは、送信元のIPアドレスごとに、1分に60回ほどまでです(おおよその値で、Cloudflareの拠点ごとに数えます)。APIキーも、利用者ごとの枠もありません。稼働の保証もありません。文字列の項目は200文字までです。

開くと、項目と、そのまま動かせる例が見られます。操作しながら見るには、APIリファレンスかPlaygroundをお使いください。

この一覧は、公開中のOpenAPI(取得日 2026-11-17、版 0.9.1)から作っています。

道筋対応するMCPツール必須の項目任意の項目
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 — 日本の祝日の一覧
項目型必須説明
yearinteger必須年
範囲: 1980 – 2099

例

curl -fsS -G 'https://biz.ossalt.jp/v1/holidays' \
  --data-urlencode 'year=2026'

返りうるHTTPの状態: 200, 400, 429, 503

GET /v1/business-days/check — 営業日かどうかの判定
項目型必須説明
datestring必須日付
calendarstring任意"standard": weekends and national holidays are closed. "bank": also closed Dec 31 - Jan 3 (Japanese bank holidays). / standard:土日・祝日が休み。bank:加えて12月31日〜1月3日が休み(銀行の休業日)
値: standard | bank
extra_holidaysstring任意会社独自の休み (comma-separated / カンマ区切り)
extra_business_daysstring任意休日でも営業日とする日 (comma-separated / カンマ区切り)

例

curl -fsS -G 'https://biz.ossalt.jp/v1/business-days/check' \
  --data-urlencode 'date=2026-12-31' \
  --data-urlencode 'calendar=bank'

返りうるHTTPの状態: 200, 400, 429, 503

GET /v1/business-days/add — Add business days / n営業日後・前
項目型必須説明
datestring必須起算日
daysinteger必須営業日の数(負なら前)
範囲: -2000 – 2000
calendarstring任意"standard": weekends and national holidays are closed. "bank": also closed Dec 31 - Jan 3 (Japanese bank holidays). / standard:土日・祝日が休み。bank:加えて12月31日〜1月3日が休み(銀行の休業日)
値: standard | bank
extra_holidaysstring任意会社独自の休み (comma-separated / カンマ区切り)
extra_business_daysstring任意休日でも営業日とする日 (comma-separated / カンマ区切り)

例

curl -fsS -G 'https://biz.ossalt.jp/v1/business-days/add' \
  --data-urlencode 'date=2026-11-17' \
  --data-urlencode 'days=5'

返りうるHTTPの状態: 200, 400, 429, 503

GET /v1/business-days/count — 期間の営業日数
項目型必須説明
startstring必須開始日
endstring必須終了日
calendarstring任意"standard": weekends and national holidays are closed. "bank": also closed Dec 31 - Jan 3 (Japanese bank holidays). / standard:土日・祝日が休み。bank:加えて12月31日〜1月3日が休み(銀行の休業日)
値: standard | bank
extra_holidaysstring任意会社独自の休み (comma-separated / カンマ区切り)
extra_business_daysstring任意休日でも営業日とする日 (comma-separated / カンマ区切り)

例

curl -fsS -G 'https://biz.ossalt.jp/v1/business-days/count' \
  --data-urlencode 'start=2026-12-01' \
  --data-urlencode 'end=2026-12-31'

返りうるHTTPの状態: 200, 400, 429, 503

GET /v1/business-days/adjust — 休みの日の前倒し・後ろ倒し
項目型必須説明
datestring必須日付
directionstring任意next = 後ろ倒し, previous = 前倒し
値: next | previous
calendarstring任意"standard": weekends and national holidays are closed. "bank": also closed Dec 31 - Jan 3 (Japanese bank holidays). / standard:土日・祝日が休み。bank:加えて12月31日〜1月3日が休み(銀行の休業日)
値: standard | bank
extra_holidaysstring任意会社独自の休み (comma-separated / カンマ区切り)
extra_business_daysstring任意休日でも営業日とする日 (comma-separated / カンマ区切り)

例

curl -fsS -G 'https://biz.ossalt.jp/v1/business-days/adjust' \
  --data-urlencode 'date=2026-11-23' \
  --data-urlencode 'direction=next'

返りうるHTTPの状態: 200, 400, 429, 503

GET /v1/business-days/last-of-month — 月末の最終営業日
項目型必須説明
yearinteger必須年
範囲: 1980 – 2099
monthinteger必須月
範囲: 1 – 12
calendarstring任意"standard": weekends and national holidays are closed. "bank": also closed Dec 31 - Jan 3 (Japanese bank holidays). / standard:土日・祝日が休み。bank:加えて12月31日〜1月3日が休み(銀行の休業日)
値: standard | bank
extra_holidaysstring任意会社独自の休み (comma-separated / カンマ区切り)
extra_business_daysstring任意休日でも営業日とする日 (comma-separated / カンマ区切り)

例

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の状態: 200, 400, 429, 503

GET /v1/japanese-era/to-era — 西暦から和暦
項目型必須説明
datestring必須日付

例

curl -fsS -G 'https://biz.ossalt.jp/v1/japanese-era/to-era' \
  --data-urlencode 'date=2019-05-01'

返りうるHTTPの状態: 200, 400, 429, 503

GET /v1/japanese-era/from-era — 和暦から西暦
項目型必須説明
warekistring必須和暦の日付

例

curl -fsS -G 'https://biz.ossalt.jp/v1/japanese-era/from-era' \
  --data-urlencode 'wareki=令和元年5月1日'

返りうるHTTPの状態: 200, 400, 429, 503

GET /v1/postal-codes/lookup — 郵便番号から住所
項目型必須説明
postal_codestring必須郵便番号(7桁、ハイフンは任意)

例

curl -fsS -G 'https://biz.ossalt.jp/v1/postal-codes/lookup' \
  --data-urlencode 'postal_code=1000001'

返りうるHTTPの状態: 200, 400, 429, 503

GET /v1/postal-codes/search — 住所から郵便番号
項目型必須説明
prefecturestring任意都道府県(任意)
citystring必須市区町村
townstring任意町域の一部(任意)
office_namestring任意事業所名の一部(任意)

例

curl -fsS -G 'https://biz.ossalt.jp/v1/postal-codes/search' \
  --data-urlencode 'prefecture=東京都' \
  --data-urlencode 'city=千代田区' \
  --data-urlencode 'town=千代田'

返りうるHTTPの状態: 200, 400, 429, 503

GET /v1/addresses/normalize — 住所の正規化(町域まで)
項目型必須説明
addressstring必須住所

例

curl -fsS -G 'https://biz.ossalt.jp/v1/addresses/normalize' \
  --data-urlencode 'address=東京都千代田区千代田1-1'

返りうるHTTPの状態: 200, 400, 429, 503

GET /v1/corporations/lookup — 法人番号から法人の情報
項目型必須説明
corporate_numberstring必須法人番号(13桁。ハイフン・空白は任意)

例

curl -fsS -G 'https://biz.ossalt.jp/v1/corporations/lookup' \
  --data-urlencode 'corporate_number=1000013050238'

返りうるHTTPの状態: 200, 400, 429, 503

GET /v1/corporations/search — 法人の名前から法人番号
項目型必須説明
namestring必須法人の名前の先頭(例:トヨタ自動車)
prefecturestring任意都道府県で絞り込む(任意)

例

curl -fsS -G 'https://biz.ossalt.jp/v1/corporations/search' \
  --data-urlencode 'name=鳥取簡易裁判所' \
  --data-urlencode 'prefecture=鳥取県'

返りうるHTTPの状態: 200, 400, 429, 503

運営:Momonga