# 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

> **Info**
>
> - 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

| Parameter | Type   | Required | Description |
| --------- | ------ | -------- | ----------- |
| x-api-key | string | Required | API Key     |

### Query Parameters

| Parameter | Type   | Required | Description                                                                                                                                                                 |
| --------- | ------ | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| discNo    | string | Required | Disclosure number (14 digits) (e.g. 20250401130100)                                                                                                                         |
| docs      | string | Optional | 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

/v2/td/files

**cURL**

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

**JavaScript**

```javascript
import axios from 'axios'

const client = axios.create({
  baseURL: 'https://api.jquants.com',
  headers: { 'x-api-key': '{{apiKey}}' },
})

await client.get('/v2/td/files', {
  params: {
    discNo: '{{discNo}}',
  },
})
```

**Python**

```python
import requests

headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
    "https://api.jquants.com/v2/td/files",
    params={"discNo": "{{discNo}}"},
    headers=headers,
)
print(resp.json())
```

### Responses

### Data Item

| Parameter        | Type   | Required | Description                      |
| ---------------- | ------ | -------- | -------------------------------- |
| discNo           | string | Required | Disclosure number (14 digits)    |
| files            | object | Required | download URL map for files       |
| files.pdf        | string | Required | download URL for the full PDF    |
| files.summaryPdf | string | Required | download URL for the summary PDF |
| files.xbrl       | string | Required | download URL for the XBRL file   |

### Response Sample

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