銘柄の開示一覧

指定した銘柄の発行体が提出した開示書類 (EDINET 法定開示・TDnet 適時開示) を開示日時の新しい順で返す。証券コードは法人の主たる上場銘柄 (本体株式) のみ指定でき、法人の主たる EDINET 提出者へ解決して返す (レスポンスの edinet_code に解決結果を含む)。書類の本文・章構成・XBRL は doc_id を GET /disclosures/{doc_id} に渡して取得する。TDnet 由来の開示は開示時刻から 24 時間以上経過したものだけを返す。MCP tool list_disclosures と同じデータを返す。該当データが 0 件のときは空配列とともに reason (code=no_results + 状況の説明) を返す。

GET/securities/{code}/disclosures

Authorization

AuthorizationBearer token · headerrequired

IRBANK Connect (app.irbank.net/mcp-api) で発行した API キー

Path parameters

codestringrequired

証券コード (4 桁)

matches ^[0-9A-Z]{4,5}$

Query parameters

fromstring

開示日の下限 (JST 暦日, YYYY-MM-DD)。この日を含む

matches ^\d{4}-\d{2}-\d{2}$

tostring

開示日の上限 (JST 暦日, YYYY-MM-DD)。この日を含む

matches ^\d{4}-\d{2}-\d{2}$

document_typestring

書類種別の前方一致フィルタ (例: 有価証券報告書)。TDnet 適時開示は書類種別を持たないため、指定すると EDINET の法定開示だけが対象になる

min length 1 · max length 100

limitinteger

1 ページの件数 (1〜100、既定 50)

min 1 · max 100 · default: 50

cursorstring

前回レスポンスの next_cursor。次ページを取得するときは証券コード・from・to・document_type・limit を前回と同じ値にする (cursor は位置だけを持ち、条件を変えると開示を飛ばしたり重複して取得したりする)

Responses

200OK

security_codestringrequired

証券コード (4 桁)

edinet_codestringrequired

証券コードから解決した法人の EDINET コード

disclosuresSecurityDisclosure[]required

開示書類の一覧 (開示日時の新しい順)

Show properties

Array of SecurityDisclosure

doc_idstringrequired

EDINET 書類管理番号 (S + 7 桁英数字) または TDnet docID (14 桁数字)。GET /disclosures/{doc_id} にそのまま渡せる

sourcestringrequired

開示ソース

Allowed:edinettdnet

document_typestring | nullrequired

書類種別 (例: 有価証券報告書)。TDnet 適時開示は null

titlestring | nullrequired

書類のタイトル

filing_datestring | nullrequired

開示日 (JST 暦日, YYYY-MM-DD)

disclosed_atstring | nullrequired

開示日時 (ISO 8601, UTC)

source_urlstring | nullrequired

出典 URL。EDINET は公開ページ (WZEK0040.aspx) の絶対 URL、TDnet は null。PDF 原本の URL ではない

pdf_urlstring | nullrequired

開示 PDF 原本の絶対 URL。EDINET / TDnet の一次配信元ではなく、IRBANK が保管した原本を配信する恒久 URL。認証なしで取得できるのは production オリジン (https://api.irbank.net) のみで、staging / beta 等それ以外の環境では IAP により取得できない。原本が保管されていない開示では 404 になる場合がある。doc_id が URL を組み立てられない形式のときは null

next_cursorstring | nullrequired

次ページ取得用の不透明 cursor。null なら最終ページ

reasonEmptyReason | anyrequired

本体データが空のとき、その理由 (機械可読な code + 説明・対処ヒント)。本体データが 1 件以上のときは null

Show properties

One of:

EmptyReason

codestringrequired

no_results: このリクエストに該当するデータが 0 件。収録が無い場合と、指定した条件に合致しない場合の両方を含む (両者は現状の実装では区別できないため、機械可読な値としては区別しない)。TDnet 由来の値は開示から 24 時間は収録に反映されないため、直近開示分は後から追加され得る

Allowed:no_results

messagestringrequired

0 件になった状況の説明 (英語)。人間向けの補足であり、分岐は code で行うこと (文面は予告なく改善されうる)

any

any

attributionAttributionrequired

Show properties

source_labelstringrequired

出典表示ラベル（第三者に表示する際はこの表記を使う）

license_notestringrequired

出典・再配信条件の注記

processed_bystringrequired

400パラメータまたは cursor が不正

errorobjectrequired

Show properties

codestringrequired

messagestringrequired

detailsExternalErrorDetail[]

Show properties

Array of ExternalErrorDetail

paramstringrequired

reasonstringrequired

Allowed:missingconflictinvalid_typeinvalid_formatout_of_rangeunknown_valuetoo_many_itemsinvalid

expectedstring

受理される値の要約（範囲・型・列挙値）。示せない場合は省略する

404銘柄が存在しない、法人の主たる上場銘柄でない、または EDINET 提出者を持たない (ETF 等)

errorobjectrequired

Show properties

codestringrequired

messagestringrequired

detailsExternalErrorDetail[]

Show properties

Array of ExternalErrorDetail

paramstringrequired

reasonstringrequired

Allowed:missingconflictinvalid_typeinvalid_formatout_of_rangeunknown_valuetoo_many_itemsinvalid

expectedstring

受理される値の要約（範囲・型・列挙値）。示せない場合は省略する

Request

curl -X GET "https://api.irbank.net/v1/securities/7203/disclosures" \
  -H "Authorization: Bearer YOUR_TOKEN"

const response = await fetch("https://api.irbank.net/v1/securities/7203/disclosures", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN"
  }
});

import requests

response = requests.get(
    "https://api.irbank.net/v1/securities/7203/disclosures",
    headers={
        "Authorization": "Bearer YOUR_TOKEN"
    },
)

Response

{
  "security_code": "7203",
  "edinet_code": "E02144",
  "disclosures": [
    {
      "doc_id": "S100ABCD",
      "source": "edinet",
      "document_type": "string",
      "title": "string",
      "filing_date": "string",
      "disclosed_at": "string",
      "source_url": "string",
      "pdf_url": "https://api.irbank.net/api/market-files/v1/edinet/S100YV72.pdf"
    }
  ],
  "next_cursor": "string",
  "reason": {
    "code": "no_results",
    "message": "No segment disclosure is currently recorded for this organization."
  },
  "attribution": {
    "source_label": "金融庁 EDINET / TDnet",
    "license_note": "string",
    "processed_by": "IRBANK"
  }
}

{
  "error": {
    "code": "not_found",
    "message": "Security not found",
    "details": [
      {
        "param": "years",
        "reason": "out_of_range",
        "expected": ">= 1"
      }
    ]
  }
}

{
  "error": {
    "code": "not_found",
    "message": "Security not found",
    "details": [
      {
        "param": "years",
        "reason": "out_of_range",
        "expected": ">= 1"
      }
    ]
  }
}