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

# List Files

`GET /{provider}/v1/files`

Returns information about a specific file. that can be used across - Assistants API, Batch API 
This is the equivalent of GET https://api.openai.com/v1/files/

Supports Identical Params as: https://platform.openai.com/docs/api-reference/files/list

Example Curl
```
curl http://localhost:4000/v1/files        -H "Authorization: Bearer sk-1234"

```

## Path parameters

- `provider` string, nullable, required

## Query parameters

- `target_model_names` string, nullable
- `purpose` string, nullable
- `limit` integer, nullable
- `after` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-18** `082b5fabd909` — 4 info
  - added the new optional `query` request parameter `after`
  - added the new optional `query` request parameter `limit`
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status

[Change history](https://skmtc.dev/flock/apis/litellm-api/changes/:provider/v1/files/get.md)

---

[API](https://skmtc.dev/flock/apis/litellm-api.md) · [All operations](https://skmtc.dev/flock/apis/litellm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/flock/apis/litellm-api/revisions/7ed45f30a5f0?raw)