# 決算発表予定日(/fins/earnings-date)

`GET`    /v2/fins/earnings-date

## APIの概要

東証上場会社等が東証に対して報告した決算発表予定日を取得できます。\
決算期によらず、報告を行った全上場銘柄（REIT等を含む）が対象で、予定日の変更・未定の履歴も含めて公表日単位で提供します。

### 本APIの留意点

> **Info**
>
> - 決算発表予定日の変更が報告された場合、以前のデータは削除されず、修正後の予定日が新たなデータとして追加されます（`code` 指定時は変更履歴を含む全レコードが返却されます）。
> - 一度公表された決算発表予定日が後から「未定」に変更された場合、SchDate は空文字（`""`）となります。
> - `scheduled_date` を指定した場合、各銘柄・各決算区分（1Q/2Q/3Q/FY）で最後に公表されたレコードのみがヒットします。そのため、予定日がその後変更された場合、変更前の予定日ではヒットしません。
> - プランごとの参照可能期間は、公表日（`PubDate`）を基準に適用されます。`date` 指定時は参照範囲外の日付を指定すると 400 エラーとなります。また、`code` / `scheduled_date` 指定時は参照範囲外の公表日のデータが結果に含まれません。

## 決算発表予定日データを取得します

`GET` `https://api.jquants.com/v2/fins/earnings-date`

データの取得では、`code`（銘柄コード）・`date`（公表日）・`scheduled_date`（発表予定日）の**いずれか1つ**の指定が必須となります。\
各パラメータの組み合わせとレスポンスの結果については以下のとおりです。

- code: ✓, date: –, scheduled\_date: – → 指定された銘柄の予定日公表履歴

- code: –, date: ✓, scheduled\_date: – → 指定日に公表・変更された全銘柄の予定日データ

- code: –, date: –, scheduled\_date: ✓ → 指定日を現在有効な発表予定日とする全銘柄のデータ

※ 2つ以上のパラメータを同時に指定することはできません（400 エラー）。\
※ 該当データが存在しない場合は空配列（`"data": []`）を返却します。

### Requests

### Headers

| Parameter | Type   | Required | Description |
| --------- | ------ | -------- | ----------- |
| x-api-key | string | Required | APIキー       |

### Query Parameters

| Parameter       | Type   | Required | Description                                   |
| --------------- | ------ | -------- | --------------------------------------------- |
| code            | string | Optional | 銘柄コード（e.g. 86970 or 8697）                     |
| date            | string | Optional | 公表日（e.g. 20250620 or 2025-06-20）              |
| scheduled\_date | string | Optional | 決算発表予定日（e.g. 20250805 or 2025-08-05）          |
| pagination\_key | string | Optional | 検索の先頭を指定する文字列 過去の検索で返却された pagination\_key を設定 |

### APIコールサンプルコード

/v2/fins/earnings-date

**cURL**

```bash
curl -G https://api.jquants.com/v2/fins/earnings-date \
-H "x-api-key: {{apiKey}}" \
-d code="{{code}}"
```

**JavaScript**

```javascript
import axios from 'axios'

const client = axios.create({
baseURL: 'https://api.jquants.com',
headers: { 'x-api-key': '{{apiKey}}' },
})

await client.get('/v2/fins/earnings-date', {
params: {
  code: '{{code}}',
},
})
```

**Python**

```python
import requests

headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
  "https://api.jquants.com/v2/fins/earnings-date",
  params={"code": "{{code}}"},
  headers=headers,
)
print(resp.json())
```

### Responses

### データ項目概要

| Parameter | Type   | Required | Description                         |
| --------- | ------ | -------- | ----------------------------------- |
| PubDate   | string | Required | 公表日（YYYY-MM-DD） この予定日が公表・変更された日     |
| SchDate   | string | Required | 決算発表予定日（YYYY-MM-DD） 未定の場合は空文字（`""`） |
| FQName    | string | Required | 決算区分（1Q / 2Q / 3Q / FY）             |
| FYE       | string | Required | 決算期末（MMDD）                          |
| Code      | string | Required | 銘柄コード（5桁）                           |
| CoName    | string | Required | 会社名                                 |
| CoNameEn  | string | Required | 会社名（英語）                             |

※ 会社名（CoName・CoNameEn）は PubDate 時点のデータです。

### レスポンスサンプル

```bash {{ title: "200:OK" }}
{
    "data": [
        {
            "PubDate": "2025-06-03",
            "SchDate": "2025-07-30",
            "FQName": "1Q",
            "FYE": "0331",
            "Code": "86970",
            "CoName": "日本取引所グループ",
            "CoNameEn": "Japan Exchange Group,Inc."
        }
    ],
    "pagination_key": "value1.value2."
}
```