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

# GET /downloads

`GET /downloads`

## Request

- Base URL: `https://api.cxxx.eagleeyenetworks.com/api/v3.0`
- URL: `https://api.cxxx.eagleeyenetworks.com/api/v3.0/downloads`
- Auth: HTTP bearer

Returns a list of downloaded items.

## Query parameters

- `sort` string[]
- `mimeType` string: The media content type.
- `mimeType__contains` string: The media content type.
- `createTimestamp__lte` string, date-time: Date and time when the item was created.
- `createTimestamp__gte` string, date-time: Date and time when the item was created.
- `expireTimestamp__lte` string, date-time: Date and time when the item was created.
- `expireTimestamp__gte` string, date-time: Date and time when the item was created.
- `directory` string: Name of the parent directory.
- `directory__contains` string: Name of the parent directory.
- `name` string: Name of the item.
- `name__contains` string: Name of the item.
- `notes__contains` string: User entered annotations.
- `size__lte` integer: Size of the file in Bytes.
- `size__gte` integer: Size of the file in Bytes.
- `tags` string[]: List of tags associated with the file.
- `tags__any` string[]: List of tags associated with the file.
- `tags__contains` string[]: List of tags associated with the file.
- `include` string[]
- `pageToken` string
- `pageSize` integer

## Response `200`

OK

- ApiPaginatedDownloadResponse: Used to wrap results for a paginated response, containing information on how to retrieve further pages and, if available, the total number of results.
  - `nextPageToken` string, nullable, required: Token to retrieve the next page. The value of this token is passed into the field pageToken. This value can be null if there is no next page.
  - `prevPageToken` string, nullable, required: Token to retrieve the previous page. The value of this token is passed into the field pageToken. This value can be null of there is no previous page.
  - `totalSize` integer, nullable: The number of resource entries being returned from the result set. This can be omitted if the API endpoint does not have total size information.
  - `results` ApiDownloadsMain[], required: The result set from a collection API call.
    - `id` string, uuid, required: The ID of the download.
    - `directory` string: Name of the parent directory.
    - `mimeType` string: The media content type.
    - `name` string: Name of the item.
    - `expireTimestamp` string, date-time
    - `status` 'available' | 'expired': Expiration status of the download. Possible values are "available" or "expired".

## Other responses

- `400`: The supplied object is invalid. Error detail will contain the validation error.
- `401`: You are not authenticated. Please authenticate and try again.
- `403`: You have no permission to access the specified resource.
- `404`: Referenced resource could not be found.
- `500`: Something went wrong in the server. Please try again.

---

[API](https://skmtc.dev/eagleeyenetworks/apis/media.md) - [All operations](https://skmtc.dev/eagleeyenetworks/apis/media/llms.txt) - [OpenAPI document](https://skmtc.dev/eagleeyenetworks/apis/media/revisions/99edf96b6511?raw)