---
title: "List files owned by the authenticated team, paginated. The response
always returns a `pagination_token`; pass it back as a query parameter
to fetch the next page. The end of the list is reached when the
returned `data` array is shorter than `limit`."
method: GET
path: "/v1/files"
tags: ["v1"]
---

# List files owned by the authenticated team, paginated. The response
always returns a `pagination_token`; pass it back as a query parameter
to fetch the next page. The end of the list is reached when the
returned `data` array is shorter than `limit`.

`GET /v1/files`

## Query parameters

- `limit` integer
- `order` string
- `sort_by` string
- `pagination_token` string
- `after` string
- `filter` string

## Response `200`

Success

- ListFilesResponse
  - `data` File[], required — List of files.
    - `bytes` integer, required — The size of the file, in bytes.
    - `created_at` integer, required — The Unix timestamp (in seconds) for file creation time.
    - `expires_at` integer, nullable — The Unix timestamp (in seconds) for file expiry time. null if file does not expire.
    - `filename` string, required — The name of the file.
    - `id` string, required — The file identifier, which can be used in other API requests.
    - `object` string, required — The object type, which is always `file`. Only included for compatability.
    - `public_url` string, nullable — Public URL for the file. Only present when the file has an active public URL.
    - `public_url_expires_at` integer, nullable — Unix timestamp (seconds) when the public URL expires. Only present when the public URL has an independent expiry.
    - `purpose` string — The intended purpose of the uploaded file. Only included for OAI compatability.
  - `pagination_token` string, nullable — Pagination token to use with next request.

---

[API](https://skmtc.net/x/apis/xai-s-rest-api.md) · [All operations](https://skmtc.net/x/apis/xai-s-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/x/xai-s-rest-api/versions/8f6014272113/schema)