TDnet/Company Disclosure Files (/td/files)

GET /v2/td/files

Overview

You can retrieve download URLs for files associated with a disclosure number (discNo).
Use the returned URLs to download PDF and XBRL files. URLs expire in 15 minutes.

Attention

This API requires the TimelyDisclosure add-on.
Data is available for the past 5 years from the disclosure date. Once that period has passed, the data can no longer be retrieved in any data format (API or CSV).
download URLs expire in 15 minutes.
Even after a disclosure has been corrected, 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.
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

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 download URLs for TDnet/Company Disclosure Files

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

Requests

Headers

x-api-keystringrequired: API Key

Query Parameters

discNostringrequired: Disclosure number (14 digits) (e.g. 20250401130100)
Specify a disclosure number obtained from the TDnet/Company Disclosure Index List.
docsstringoptional: Types of files to retrieve (multiple values can be specified separated by commas)
g: full PDF, s: summary PDF, x: XBRL
If omitted, all types are returned (e.g. g or g,s,x)

Sample Code

Request

GET

/v2/td/files

curl -G https://api.jquants.com/v2/td/files \
-H "x-api-key: {loading}" \
-d discNo="20250401130100"

Responses

Data Item

discNostring: Disclosure number (14 digits)
filesobject: download URL map for files
files.pdfstring: download URL for the full PDF
files.summaryPdfstring: download URL for the summary PDF
files.xbrlstring: download URL for the XBRL file

Response Sample

{
    "discNo": "20250401130100",
    "files": {
        "pdf": "https://example.com/download-url-pdf",
        "summaryPdf": "https://example.com/download-url-summary",
        "xbrl": "https://example.com/download-url-xbrl"
    }
}