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.
download URLs expire in 15 minutes.

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)
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"
    }
}