---
title: "IR PDF 配信 - 検索 / 一覧 (プレビュー)"
method: GET
path: "/ir/documents"
tags: ["IR PDF Distribution"]
---

# IR PDF 配信 - 検索 / 一覧 (プレビュー)

`GET /ir/documents`

## Request

- Base URL: `https://edinetdb.jp/v1`
- URL: `https://edinetdb.jp/v1/ir/documents`
- Auth: API key in header `X-API-Key`

統合報告書・サステナビリティレポート・中期経営計画書・決算説明資料など、各社 IR ページに掲載されている
PDF 原本へのアクセスを提供する。EDINET 由来の有報 / 四半期報告書とは別系統 (各社 IR サイトからクロール → GCS キャッシュ)。

**重要**: プレビュー機能。プレビューが有効な環境でのみ動作。本番公開前は 404。

各 doc は配信 VIEW で `is_active = TRUE AND delivery_status = 'available'` + opt-out 企業除外を強制。
レスポンスは PDF 本体を含まない (pdf_url は別 EP `/v1/ir/documents/{doc_id}/pdf-url` で発行)。

過去分の提供範囲は [利用規約第12条](https://edinetdb.jp/legal/terms#ir-pdf-distribution) に基づく。

## Query parameters

- `company` string[]
- `type` string[]
- `fiscal_year` integer
- `fiscal_year_is_null` boolean
- `include_unknown_year` boolean
- `published_after` string, date
- `published_before` string, date
- `language` 'ja' | 'en' | 'unknown'
- `is_latest_only` boolean
- `industry` string
- `q` string
- `cursor` string
- `limit` integer

## Response `200`

検索結果。meta.next_cursor が NULL でなければ次ページあり

## Other responses

- `400`: パラメータ不正
- `404`: 機能プレビュー中

---

[API](https://skmtc.dev/edinetdb/apis/edinet-db-api.md) · [All operations](https://skmtc.dev/edinetdb/apis/edinet-db-api/llms.txt) · [OpenAPI document](https://skmtc.dev/edinetdb/apis/edinet-db-api/revisions/d896c5f7d472?raw)