Skip to main content
GET
https://api.neosantara.xyz
/
v1
/
files
/
:file_id
Get File
curl --request GET \
  --url https://api.neosantara.xyz/v1/files/:file_id \
  --header 'x-api-key: <api-key>'
{
  "id": "<string>",
  "object": "<string>",
  "bytes": 123,
  "created_at": 123,
  "filename": "<string>",
  "purpose": "<string>",
  "status": "<string>",
  "status_details": {}
}
Retrieve metadata information about a specific uploaded file.
file_id
string
required
The ID of the file to retrieve (e.g., file-abc123).

Returns

id
string
The unique identifier of the file.
object
string
The object type, which is always file.
bytes
integer
The size of the file in bytes.
created_at
integer
The Unix timestamp (in seconds) of when the file was created.
filename
string
The name of the file.
purpose
string
The purpose of the file.
status
string
The current status of the file.
status_details
string or null
Additional details about the file status.

Return Examples

Response 200
{
  "id": "file-abc123",
  "object": "file",
  "bytes": 120000,
  "created_at": 1699564800,
  "filename": "batch_requests.jsonl",
  "purpose": "batch",
  "status": "uploaded",
  "status_details": null
}
Error 404 - File Not Found
{
  "error": {
    "message": "File not found or access denied",
    "type": "invalid_request_error",
    "code": "file_not_found"
  }
}
Error 410 - File Expired
{
  "error": {
    "message": "File has expired",
    "type": "invalid_request_error",
    "code": "file_expired"
  }
}