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

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

x-api-keystringrequired: API Key

Query Parameters

No query parameters.

Sample Code

Request

GET

/v2/td/bulk

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

Responses

Data Item

lastUpdatedstring: Last updated timestamp of the CSV file (ISO 8601, e.g. 2025-04-01T08:00:00Z)
urlstring: download URL for the CSV file (gzip compressed)

Response Sample

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

CSV Data Items

DiscNostring: Disclosure number (14 digits)
Codestring: Issue code
Namestring: Company name (Japanese)
DiscDatestring: Disclosure date (YYYY-MM-DD)
DiscTimestring: Disclosure time (HH:MM)
Titlestring: Disclosure title (Japanese)
DiscStatusstring: Handling type (null: new disclosure, 'revision': corrected disclosure, 'delete': deleted disclosure)
RevNostring: Disclosure revision number (1 to 99)
DiscItemsstring: Public item codes (| separated)
Docsstring: Document types (| separated) (g: full PDF, s: summary PDF, x: XBRL)

CSV Data Sample

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