List files | OpenRouter | Documentation

Lists files belonging to the workspace of the authenticating API key.

AuthorizationBearer

API key as bearer token in Authorization header

limitintegerOptional1-1000

Maximum number of files to return (1–1000).

cursorstringOptional

Opaque pagination cursor from a previous response.

workspace_idstringOptionalformat: "uuid"

Workspace to scope the request to. Defaults to the caller’s default workspace.

A page of files.

cursorstring or null

Opaque cursor for the next page; null when there are no more results.

datalist of objects

first_idstring or null

has_moreboolean

last_idstring or null

400

Bad Request Error

401

Unauthorized Error

429

Too Many Requests Error

500

Internal Server Error

1	{
2	"cursor": null,
3	"data": [
4	{
5	"created_at": "2025-01-01T00:00:00Z",
6	"downloadable": false,
7	"filename": "document.pdf",
8	"id": "file_011CNha8iCJcU1wXNR6q4V8w",
9	"mime_type": "application/pdf",
10	"size_bytes": 1024000,
11	"type": "file"
12	}
13	],
14	"first_id": "file_011CNha8iCJcU1wXNR6q4V8w",
15	"has_more": false,
16	"last_id": "file_011CNha8iCJcU1wXNR6q4V8w"
17	}