---
title: "List"
method: GET
path: "/account/downloads"
tags: ["Downloads"]
---

# List

`GET /account/downloads`

Returns details about all file downloads performed during the last 90 days. By default, GET operations, which return a list of requested items, return only the first 25 items. To get a different set of items, you can use the offset and limit parameters in the query string of the GET request.

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

Operation successful

- FilesListResponse — FilesListResponse returns file meta data entity
  - `data` FilesListData — FilesListPagination includes pagination data
    - `limit` integer — The limit used for this page of results. This will be the same as the `limit` query parameter unless it exceeded the maximum value allowed for this API endpoint.
    - `offset` integer — The offset used for this page of results.
    - `total_items` integer — The number of files that are or were available for download for the user.
    - `items` FileMetaData[]
      - `download_url` string — The URL where the file can be downloaded for. The field is present only if the file status equals to `success` and its lifetime is not expired.
      - `file_format` string — The file format. This will be the same as the `file_format` query parameter passed to the download initiation API endpoint. Supported values: ndjson, csv.
      - `id` integer — The unique identifier that represents the file creation process. This identifier is assigned to the file and returned by the download initiation API endpoint when the client initiates file creation process.
      - `request_description` string — An optional field that the client can pass as a query parameter `description` to the download initiation API endpoint. Max length: 254 characters.
      - `request_id` string — The unique identifier assigned to the file download is associated with the download initiation HTTP request. If any errors occur this identifier should be provided to the service staff and will be used for troubleshooting.
      - `requested_at` string, date-time — The date when the file creation was requested by the client.
      - `rows_count` integer — The number of rows present in the file.
      - `status` string — The status of the file creation: `success` - The file was created successfully. `pending` - The file creation process is still running. `failed` - The file creation failed due to an internal error. `removed` - The file was removed after its lifetime expiration and is not available for download anymore. All files are removed 90 days after their creation.
      - `updated_at` string, date-time — The date when the file information was updated last time.

## Other responses

- `401` — Unauthorized
- `500` — Internal server error

---

[API](https://skmtc.dev/spyse/apis/data-api.md) · [All operations](https://skmtc.dev/spyse/apis/data-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/spyse/data-api/revisions/fd05b83ed2c5/schema)