# Downloads

> For the complete machine-readable documentation index, see [llms.txt](https://apidocs.chargebee.com/llms.txt).


Requesting to download a file through this API will return the `download_url` attribute as the response. This attribute will contain a URL that will allow the requested content to be downloaded.

## Sample Download

```json
{
  "download_url": "https://cb-downloads-dev.s3.amazonaws.com/<your-site>/invoice_rI8lOV4vCCpI.pdf",
  "valid_till": 1528093653
}
```

## Downloads attributes

## Input Parameters

- `download_url` (required, string, max chars=3500)
  The URL at which the file is available for download.

- `valid_till` (required, timestamp(UTC) in seconds)
  The time until which the `download_url` is valid.

- `mime_type` (optional, string, max chars=100)
  The [media type](https://en.wikipedia.org/wiki/Media_type) of the file.