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

# List Files

`GET /file`

## Query parameters

- `purpose` string, required

## Response `200`

- File[]
  - `object` 'file'
  - `status` 'processing' | 'done' | 'failed'
  - `name` string — This is the name of the file. This is just for your own reference.
  - `originalName` string
  - `bytes` number
  - `purpose` string
  - `mimetype` string
  - `key` string
  - `path` string
  - `bucket` string
  - `url` string
  - `parsedTextUrl` string
  - `parsedTextBytes` number
  - `metadata` object
  - `id` string, required — This is the unique identifier for the file.
  - `orgId` string, required — This is the unique identifier for the org that this file belongs to.
  - `createdAt` string, date-time, required — This is the ISO 8601 date-time string of when the file was created.
  - `updatedAt` string, date-time, required — This is the ISO 8601 date-time string of when the file was last updated.

---

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