J-Quants API
View as Markdown

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.
  • No webhook is provided to notify you of file updates.
  • The CSV provided by this API is generated from the same index information as the TDnet/Company Disclosure Index List (/td/list); there is no difference in data items or level of detail between the two.
  • If you retrieve the current day's timely disclosures on an ongoing basis, we recommend differential retrieval with the cursor parameter. See Retrieving Differential Data Using Cursor.
  • We do not provide the date and time when each data item became available on J-Quants. For update frequency and approximate update times, see Update Timing of Provided Data.
  • Questions we have received about data specifications are also answered in the FAQ (Data & Specs).

Data correction policy

  • A corrected timely disclosure is added as a separate record with a new disclosure number (DiscNo) (the same behavior as TDnet/Company Disclosure Index List).
  • The full revision history and correction, cancellation and deletion information are not provided. Disclosures before and after a correction are not provided as linked revisions, and no item is provided that lets you mechanically identify which disclosure a corrected disclosure corrects or deletes.
  • In this service, we may add or overwrite data due to data deficiencies or omissions. In such cases, the correction history is recorded on Data Correction History and Known issues, so please refer to it.
    Note: In these cases, neither the correction history nor pre-correction data is provided via the API, CSV, or other means.

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, JST)
This can be used as the official TDnet disclosure date.
DiscTimestring
Disclosure time (HH:MM, JST)
This can be used as the official TDnet disclosure time.
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)
The public item codes conform to Appendix 1 of the TDnet API Specifications.
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

Was this page helpful?