TDnet/Company Disclosure Index List (/td/list)

GET /v2/td/list

Overview

You can retrieve a list of timely disclosure index information (e.g. disclosure number, date/time, title).
Specify a date or issue code to retrieve data.

Attention

This API requires the TimelyDisclosure add-on.
Coverage
- This API provides data on issues listed on the financial instruments exchanges in Japan (Tokyo Stock Exchange, Nagoya Stock Exchange, Fukuoka Stock Exchange and Sapporo Securities Exchange).
- This API covers the disclosures distributed via TDnet without excluding any disclosure category.
- Data is available for the past 5 years.
No webhook is provided to notify you of new or updated disclosures. To retrieve same-day disclosures incrementally, use Retrieving Differential Data Using Cursor.
This API and Financial Data (Summary only) are not synchronized. Even on the Premium plan, the financial data for a disclosure may not yet be retrievable at the point this API reports the new disclosure.
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

When a disclosure document itself is corrected, a new disclosure number (DiscNo) is assigned and the correction is added as a new record. The existing record is not overwritten.
Even after a correction or change, the original disclosure data remains retrievable. As long as it is within the available data period (the past 5 years), you can specify the old DiscNo to retrieve the file as it was at that time from TDnet/Company Disclosure Documents.
When only the title of a disclosure document is corrected, that correction is not reflected in the information retrieved from this API.
Even when a timely disclosure is deleted, this API still returns that disclosure.
Neither this API (/td/list) nor TDnet/Company Disclosure Index Bulk Download (/td/bulk) provides the full revision history or correction, cancellation and deletion information. Disclosures before and after a correction are not provided as linked revisions, and the current specification provides no item that lets you mechanically identify which disclosure a corrected disclosure corrects or deletes. To identify the original disclosure, consider matching on Code, Title, DiscItems (disclosure item codes), and similar fields.

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 List

GET https://api.jquants.com/v2/td/list

Either a date (date) or an issue code (code) must be specified to retrieve data.

Parameter and Response

Either a date (date) or an issue code (code) must be specified.
Parameter in the request and results are as below:

date	code	from/to	Results
			List of disclosures on the specified date
			List of disclosures for the specified issue (last 5 years)
			List of disclosures for the specified issue during the specified period

Retrieving disclosures using cursor

For the cursor-based real-time differential retrieval specification, see Retrieving Differential Data Using Cursor.

Requests

Headers

x-api-keystringrequired: API Key

Query Parameters

Either date or code must be specified.

datestringoptional: Disclosure date (e.g. 20250401 or 2025-04-01)
codestringoptional: Issue code (e.g. 13010 or 1301)
If a 4-character code is specified, 0 is appended at the end.
fromstringoptional: Start date (e.g. 20250301 or 2025-03-01)
Used in combination with code. Must be specified together with to.
tostringoptional: End date (e.g. 20250401 or 2025-04-01)
Used in combination with code. Must be specified together with from.
discItemsstringoptional: Filter by public item code (multiple values can be specified separated by commas, AND condition) (e.g. 11101 or 11101,11102)
For the list of public item codes, refer to Appendix 1 of the TDnet API Specifications.
cursorstringoptional: Pagination key for real-time retrieval of today's data
Use the value returned as cursor in the previous response. Cannot be specified together with pagination_key.
pagination_keystringoptional: Pagination key
Use the value returned as pagination_key in the previous response. Cannot be specified together with cursor.

Sample Code

Request

GET

/v2/td/list

curl -G https://api.jquants.com/v2/td/list \
-H "x-api-key: {loading}" \
-d date="20250401"

Responses

Data Item

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[]: List of public item codes
Docsstring[]: List of document types (g: full PDF, s: summary PDF, x: XBRL)
cursorstring: Time pointer indicating up to which disclosure has been fetched (returned only when date equals today and all results fit in a single response without pagination)
pagination_keystring: Pagination key

Response Sample

{
    "data": [
        {
            "DiscNo": "20250401130100",
            "Code": "86970",
            "Name": "日本取引所グループ",
            "DiscDate": "2025-04-01",
            "DiscTime": "08:00",
            "Title": "2025年3月期 決算短信〔日本基準〕（連結）",
            "DiscStatus": null,
            "RevNo": "1",
            "DiscItems": ["11101"],
            "Docs": ["g", "s", "x"]
        }
    ],
    "cursor": "eyJkIjoiMjAyNS0wNC0wMSIsInQiOiIyMDI1LTA0LTAxVDA4OjAwOjAwWiMyMDI1MDQwMTEzMDEwMCJ9"
}