---
title: "Get a list of files"
method: GET
path: "/v1/files"
tags: ["files"]
---

# Get a list of files

`GET /v1/files`

Get a list of files filtered by session ID

## Query parameters

- `sessionIds` string
- `offset` integer
- `limit` integer

## Headers

- `Authorization` string, required

## Response `200`

OK

- TypeFilesResponse
  - `data` TypeFilesWithPagination, required
    - `files` TypeExternalFile[] — List of files.
      - `deleted` boolean, required — Whether the file has been deleted
      - `deletionTime` string, date-time — Time when the file was deleted
      - `expiryTime` string, date-time — Time when the file will be deleted
      - `fileBytes` integer, required — Size of the file in bytes
      - `fileName` string, required — Name of the file
      - `fileType` string, required — Type of the file
      - `id` string, uuid, required — ID of the file
      - `lastHeartbeatTime` string, date-time — Time when the file was last heartbeated
      - `orgId` string, uuid, required — ID of the organization
      - `sessionIds` string[] — IDs of the associated sessions
      - `status` string, required — Status of the file
      - `uploadCompleteTime` string, date-time — Time when the file was uploaded
      - `uploadStartTime` string, date-time, required — Time when the file was uploaded
      - `visibleInApi` boolean, required — Whether the file is visible in the API
      - `visibleInPortal` boolean, required — Whether the file is visible in the portal
    - `pagination` TypePagination, required
      - `currentLimit` integer, required — The number of items to return
      - `currentPage` integer, required — The current page number
      - `finalCount` integer, required — The final count of items displayed on the current page
      - `hasMore` boolean, required — Whether there are more items
      - `initialCount` integer, required — The initial count of items displayed on the current page
      - `nextOffset` integer, required — The number of items to skip
      - `numberOfPages` integer, required — The total number of pages
      - `totalItems` integer, required — The total number of items
  - `errors` TypeIssue[]
    - `code` string — Issue code.
    - `details` object — Any associated details.
    - `message` string, required — Message describing the issue.
    - `reason` string — Underlying reason for the issue.
  - `meta` TypeEnvelopeDefaultMeta, required
    - `requestId` string
  - `warnings` TypeIssue[]
    - `code` string — Issue code.
    - `details` object — Any associated details.
    - `message` string, required — Message describing the issue.
    - `reason` string — Underlying reason for the issue.

---

[API](https://skmtc.net/airtop/apis/airtop-api.md) · [All operations](https://skmtc.net/airtop/apis/airtop-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/airtop/airtop-api/revisions/4a02eb5d21ca/schema)