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.
Data is available for the past 5 years.
In the current implementation, the following behavior applies when a timely disclosure is corrected or deleted:
- If the title of a disclosure file is corrected, the correction is not reflected in the data returned by this API.
- If a disclosure file itself is corrected, a new disclosure number is assigned and it is treated as a new record.
- Even if a disclosure is deleted, this API continues to return the disclosure.
In the current implementation, DiscStatus is always null and RevNo is always 1.

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)
DiscTimestring: Disclosure time (HH:MM)
Titlestring: Disclosure title (Japanese)
DiscStatusstring: Handling type (null: new disclosure, 'revision': corrected disclosure, 'delete': deleted disclosure)
RevNonumber: 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"
}