---
title: "List Files"
method: GET
path: "/v1/files"
tags: ["files"]
---

# List Files

`GET /v1/files`

List files that Chariot stores on your behalf. [Create a File Link](/api/files/create-link) to download
the file's contents.

## Query parameters

- `limit` integer
- `cursor` string

## Response `200`

The response for Files.list

- object
  - `results` File[]
    - `id` string — The unique identifier for the file.
    - `file_name` string — The name of the file.
    - `description` string, nullable — The description of the file.
    - `purpose` 'manual_upload' | 'grant_letter' | 'integration_download' | 'inbound_mail_item' | 'inbound_mail_item_thumbnail' | 'inbound_email' | 'inbound_email_attachment' | 'bank_check_image_front' | 'bank_check_image_back' | 'check_attachment' | 'bank_statement' | 'bank_account_verification_letter' | 'automation_output' | 'export' | 'other' — The file's purpose. Note that entries may be added to this list without notice.
    - `content_type` string — The MIME type of the file.
    - `size_bytes` integer — The size of the file in bytes.
    - `created_at` string, date-time — The date and time when the file was created.
    - `updated_at` string, date-time — The date and time when the file was last updated.
  - `next_page_token` string — A cursor token to use to retrieve the next page of results by making another API call to the same endpoint with the same parameters (only changing the pageToken). If specified, then more results exist on the server that were not returned, otherwise no more results exist on the server.

## Other responses

- `400` — The request is invalid or contains invalid parameters
- `401` — Unauthorized. The request is missing the security (OAuth2 Bearer token) requirements and the server is unable to verify the identify of the caller.
- `403` — Access denied
- `500` — Internal Server Error

## Changes

- **2026-08-31** `6f769ddf43bd` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/chariot-giving/apis/specs/changes/v1/files/get.md)

---

[API](https://skmtc.dev/chariot-giving/apis/specs.md) · [All operations](https://skmtc.dev/chariot-giving/apis/specs/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/chariot-giving/specs/revisions/6f769ddf43bd/schema)