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文字までです。
エンドポイント
Section titled “エンドポイント”開くと、項目と、そのまま動かせる例が見られます。操作しながら見るには、APIリファレンスかPlaygroundをお使いください。
この一覧は、公開中のOpenAPI(取得日 2026-11-17、版 0.9.1)から作っています。
| 道筋 | 対応するMCPツール | 必須の項目 | 任意の項目 |
|---|---|---|---|
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 — 日本の祝日の一覧
| 項目 | 型 | 必須 | 説明 |
|---|---|---|---|
year | integer | 必須 | 年 範囲: 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 — 営業日かどうかの判定
| 項目 | 型 | 必須 | 説明 |
|---|---|---|---|
date | string | 必須 | 日付 |
calendar | string | 任意 | "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_holidays | string | 任意 | 会社独自の休み (comma-separated / カンマ区切り) |
extra_business_days | string | 任意 | 休日でも営業日とする日 (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営業日後・前
| 項目 | 型 | 必須 | 説明 |
|---|---|---|---|
date | string | 必須 | 起算日 |
days | integer | 必須 | 営業日の数(負なら前) 範囲: -2000 – 2000 |
calendar | string | 任意 | "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_holidays | string | 任意 | 会社独自の休み (comma-separated / カンマ区切り) |
extra_business_days | string | 任意 | 休日でも営業日とする日 (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 — 期間の営業日数
| 項目 | 型 | 必須 | 説明 |
|---|---|---|---|
start | string | 必須 | 開始日 |
end | string | 必須 | 終了日 |
calendar | string | 任意 | "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_holidays | string | 任意 | 会社独自の休み (comma-separated / カンマ区切り) |
extra_business_days | string | 任意 | 休日でも営業日とする日 (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 — 休みの日の前倒し・後ろ倒し
| 項目 | 型 | 必須 | 説明 |
|---|---|---|---|
date | string | 必須 | 日付 |
direction | string | 任意 | next = 後ろ倒し, previous = 前倒し 値: next | previous |
calendar | string | 任意 | "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_holidays | string | 任意 | 会社独自の休み (comma-separated / カンマ区切り) |
extra_business_days | string | 任意 | 休日でも営業日とする日 (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 — 月末の最終営業日
| 項目 | 型 | 必須 | 説明 |
|---|---|---|---|
year | integer | 必須 | 年 範囲: 1980 – 2099 |
month | integer | 必須 | 月 範囲: 1 – 12 |
calendar | string | 任意 | "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_holidays | string | 任意 | 会社独自の休み (comma-separated / カンマ区切り) |
extra_business_days | string | 任意 | 休日でも営業日とする日 (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 — 西暦から和暦
| 項目 | 型 | 必須 | 説明 |
|---|---|---|---|
date | string | 必須 | 日付 |
例
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 — 和暦から西暦
| 項目 | 型 | 必須 | 説明 |
|---|---|---|---|
wareki | string | 必須 | 和暦の日付 |
例
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_code | string | 必須 | 郵便番号(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 — 住所から郵便番号
| 項目 | 型 | 必須 | 説明 |
|---|---|---|---|
prefecture | string | 任意 | 都道府県(任意) |
city | string | 必須 | 市区町村 |
town | string | 任意 | 町域の一部(任意) |
office_name | string | 任意 | 事業所名の一部(任意) |
例
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 — 住所の正規化(町域まで)
| 項目 | 型 | 必須 | 説明 |
|---|---|---|---|
address | string | 必須 | 住所 |
例
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_number | string | 必須 | 法人番号(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 — 法人の名前から法人番号
| 項目 | 型 | 必須 | 説明 |
|---|---|---|---|
name | string | 必須 | 法人の名前の先頭(例:トヨタ自動車) |
prefecture | string | 任意 | 都道府県で絞り込む(任意) |
例
curl -fsS -G 'https://biz.ossalt.jp/v1/corporations/search' \
--data-urlencode 'name=鳥取簡易裁判所' \
--data-urlencode 'prefecture=鳥取県'返りうるHTTPの状態: 200, 400, 429, 503
運営:Momonga