日付・タイムゾーン・欠損値
日付とタイムゾーン
- 日付は
YYYY-MM-DD、日時は ISO 8601 で返します - 開示日時・営業日はすべて JST（日本標準時） 基準です
欠損値の意味
null には複数の意味があります。
| ケース | 例 |
|---|---|
| 会計基準上存在しない | IFRS 企業の経常利益 |
| 企業が非開示 | 一部のセグメント情報 |
| 収録期間外 | ライセンス上提供できない期間 |
| 未到来・未確定 | 未発表の決算 |
空配列の意味（reason フィールド）
リクエストは成功したがデータが 0 件の場合、レスポンスは 404 ではなく 200 + 空配列です。このとき、なぜ空かをトップレベルの reason フィールドで返します（データが 1 件以上ある場合は null）。
{
"segments": [],
"reason": {
"code": "no_results",
"message": "No segment disclosure is currently recorded for this organization within the most recent 20 fiscal years. Companies operating in a single segment do not disclose segment information. Values sourced from TDnet become available 24 hours after disclosure, so very recent disclosures may appear later."
}
}reason.code は現在 no_results の 1 値です。message は人間向けの補足なので、分岐は必ず code で行ってください（message の文面は予告なく改善されることがあります）。
| code | 意味 | 対処 |
|---|---|---|
no_results |
このリクエストに該当するデータが 0 件。収録が無い場合と指定した条件に合致しない場合の両方を含みます（両者は現在の実装では区別できないため、機械可読な値としては区別していません） | 通常はリトライ不要。ただし TDnet 由来のデータは開示から 24 時間は未収録のため、直近開示分は後から追加されることがあります（下記「配信制約による欠損」を参照）。条件を指定していた場合は、message に実際に適用された条件が入るので参考にしてください |
message は適用された条件（fiscal_year / period / as_of / from / to / cursor 等）を事実として述べますが、「その条件を外せば取得できる」ことは意味しません。たとえばセグメントを 1 件も開示していない企業では、fiscal_year を外しても 0 件のままです。
一時的にデータを解決できずサーバー側が回答を返せない場合は、200 ではなく 503 + {"error": {"code": "data_unavailable", ...}} を返します（指数バックオフで再試行してください）。「空である」ことと「答えを出せない」ことがステータスコードで区別できます。
対象は /segments /financials /indicators /dividends /shareholders /valuations /peers /securities/{code}/prices /securities/{code}/officers /persons/{id}/appointments /persons/{id}/compensation-history /persons/{id}/holdings /rankings/{metric} です。
reason が付かないエンドポイントと、その理由:
/securitiesの一覧・/screening— 検索系。「条件に合致する銘柄が 0 件」は結果そのものであり、理由の説明を要しません/persons/{id}（プロファイル） — 氏名・生年月日という本体を返すため、current_appointmentsが空でもレスポンス自体は空ではありません。全て退任済みの人物がこれに当たり、過去の就任先は/persons/{id}/appointmentsで取得できます/organizations/{edinet_code}—listed_security_codesは必ず 1 件返ります（上場していない法人は404）/disclosures/{doc_id}・/disclosures/{doc_id}/sections/{section}— 該当セクションが無い場合はavailable_sectionsで取得可能なセクションを案内します/industries・/screening/fields— 固定のマスタ・カタログで空になりません
配信制約による欠損
適時開示（TDnet）由来のデータは、開示から 24 時間以内は返しません。同じ企業の同じ項目でも、IRBANK の Web サイトと API とで表示が異なる場合があります。詳細はデータカタログを参照してください。