Retrieve file

Get information about a specific file by its ID. Returns metadata including filename, size, creation time, and purpose. <Note> **Customer credentials required**: This endpoint requires your own OpenAI API key configured in Respan dashboard (Settings → Providers). </Note> ## Path parameters - `file_id` *string* **required**: The unique identifier of the file to retrieve. Format: `file-xxxxx` **Example** ``` file-abc123 ``` ## Response Returns the file object with metadata. ```json 200 OK { "id": "file-abc123", "object": "file", "bytes": 1024, "created_at": 1677610602, "filename": "batch_input.jsonl", "purpose": "batch" } ``` ```json 404 Not Found { "error": { "message": "No such file: file-abc123", "type": "invalid_request_error" } } ``` ```json 401 Unauthorized { "error": "Authentication credentials were not provided." } ``` ```python Python file_id = "file-abc123" url = f"https://api.respan.ai/api/files/{file_id}/" headers = { "Authorization": "Bearer YOUR_API_KEY" } response = requests.get(url, headers=headers) print(response.json()) ``` ```typescript TypeScript const fileId = 'file-abc123'; const url = `https://api.respan.ai/api/files/${fileId}/`; const headers = { 'Authorization': 'Bearer YOUR_API_KEY' }; const response = await fetch(url, { method: 'GET', headers: headers }); const data = await response.json(); console.log(data); ``` ```bash cURL curl https://api.respan.ai/api/files/file-abc123/ \ -H "Authorization: Bearer YOUR_API_KEY" ```