# TDnet/Company Disclosure Index CSV Download (/td/bulk)

`GET`    /v2/td/bulk

## Overview

You can retrieve the download URL and last updated timestamp for a CSV file (gzip compressed) containing the past 5 years of timely disclosure index information.\
Use the returned URL to download the CSV file. URLs expire in 15 minutes.

### Attention

> **Info**
>
> - This API requires the TimelyDisclosure add-on.
> - The CSV contains disclosure data for the past 5 years.
> - download URLs expire in 15 minutes.
> - The CSV file is gzip compressed.

## Retrieve TDnet/Company Disclosure Index CSV Download URL

`GET` `https://api.jquants.com/v2/td/bulk`

### Requests

### Headers

| Parameter | Type   | Required | Description |
| --------- | ------ | -------- | ----------- |
| x-api-key | string | Required | API Key     |

### Query Parameters

No query parameters.

### Sample Code

/v2/td/bulk

**cURL**

```bash
curl -G https://api.jquants.com/v2/td/bulk \
-H "x-api-key: {{apiKey}}"
```

**JavaScript**

```javascript
import axios from 'axios'

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

await client.get('/v2/td/bulk')
```

**Python**

```python
import requests

headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
    "https://api.jquants.com/v2/td/bulk",
    headers=headers,
)
print(resp.json())
```

### Responses

### Data Item

| Parameter   | Type   | Required | Description                                                                  |
| ----------- | ------ | -------- | ---------------------------------------------------------------------------- |
| lastUpdated | string | Required | Last updated timestamp of the CSV file (ISO 8601, e.g. 2025-04-01T08:00:00Z) |
| url         | string | Required | download URL for the CSV file (gzip compressed)                              |

### Response Sample

```bash {{ title: "200:OK" }}
{
    "lastUpdated": "2025-04-01T08:00:00Z",
    "url": "https://example.com/download-url-bulk-csv"
}
```

## CSV Data Items

| Parameter  | Type   | Required | Description                                                                                          |
| ---------- | ------ | -------- | ---------------------------------------------------------------------------------------------------- |
| DiscNo     | string | Required | Disclosure number (14 digits)                                                                        |
| Code       | string | Required | Issue code                                                                                           |
| Name       | string | Required | Company name (Japanese)                                                                              |
| DiscDate   | string | Required | Disclosure date (YYYY-MM-DD)                                                                         |
| DiscTime   | string | Required | Disclosure time (HH:MM)                                                                              |
| Title      | string | Required | Disclosure title (Japanese)                                                                          |
| DiscStatus | string | Required | Handling type (null: new disclosure, 'revision': corrected disclosure, 'delete': deleted disclosure) |
| RevNo      | string | Required | Disclosure revision number (1 to 99)                                                                 |
| DiscItems  | string | Required | Public item codes (`\|` separated)                                                                   |
| Docs       | string | Required | Document types (`\|` separated) (g: full PDF, s: summary PDF, x: XBRL)                               |

## CSV Data Sample

```csv
DiscNo,Code,Name,DiscDate,DiscTime,Title,DiscStatus,RevNo,DiscItems,Docs
20250401130100,86970,日本取引所グループ,2025-04-01,08:00,2025年3月期 決算短信〔日本基準〕（連結）,,1,11101,g|s|x
20250401130200,86970,日本取引所グループ,2025-04-01,09:00,2025年3月期 有価証券報告書,,1,11102,g|x
```