Retrieve a file

GET

https://api.respan.ai/api/files/:file_id/

Retrieve metadata for a file from the upstream OpenAI Files API.

Authentication

AuthorizationBearer

Use your Respan API key for Respan API authentication. Enter only the Respan API key value; clients send Authorization: Bearer <RESPAN_API_KEY>. For /api/responses, OpenAI or Azure OpenAI provider credentials go in Settings -> Providers or the request body credential_override field, not in this auth field.

Path parameters

file_idstringRequired

OpenAI file ID.

Response

File details.

idstring

File ID.

objectstring

bytesinteger

File size in bytes.

created_atinteger

Unix timestamp.

filenamestring

purposestring

statusstring

File status.

status_detailsany or null

Provider status details, when available.

Errors

401

Unauthorized Error

404

Not Found Error

1	{
2	"id": "file-abc123",
3	"object": "file",
4	"bytes": 12345,
5	"created_at": 1710000000,
6	"filename": "batch_input.jsonl",
7	"purpose": "batch",
8	"status": "processed",
9	"status_details": null
10	}