Skip to main content
GET
/
files
/
{file_id}
Get file metadata
curl --request GET \
  --url https://openrouter.ai/api/v1/files/{file_id} \
  --header 'Authorization: Bearer <token>'
{
  "created_at": "2025-01-01T00:00:00Z",
  "downloadable": false,
  "filename": "document.pdf",
  "id": "file_011CNha8iCJcU1wXNR6q4V8w",
  "mime_type": "application/pdf",
  "size_bytes": 1024000,
  "type": "file"
}

Authorizations

​
Authorization
string
header
required

API key as bearer token in Authorization header

Path Parameters

​
file_id
string
required
Example:

"file_011CNha8iCJcU1wXNR6q4V8w"

Query Parameters

​
workspace_id
string<uuid>

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

Example:

"a103d8b6-42f0-4e50-9a3c-bf41e2c3c1a7"

Response

The file metadata.

Metadata describing a stored file.

​
created_at
string
required
​
downloadable
boolean
required
​
filename
string
required
​
id
string
required
​
mime_type
string
required
​
size_bytes
integer
required
​
type
enum<string>
required
Available options:
file