Skip to main content
GET
https://api.neosantara.xyz
/
v1
/
files
List Files
curl --request GET \
  --url https://api.neosantara.xyz/v1/files \
  --header 'x-api-key: <api-key>'
{
  "object": "<string>",
  "data": [
    {
      "id": "<string>",
      "object": "<string>",
      "bytes": 123,
      "created_at": 123,
      "filename": "<string>",
      "purpose": "<string>",
      "status": "<string>",
      "status_details": {}
    }
  ],
  "has_more": true
}
List all files that belong to the authenticated user.
purpose
string
Filter files by purpose. If provided, only files with the specified purpose will be returned. Valid values: batch, assistants, fine-tune.
limit
integer
default:"20"
The maximum number of files to return. Maximum value is determined by the API.
after
string
A cursor for pagination. Use the ID of the last file from the previous page to get the next page of results.

Returns

object
string
The object type, which is always list.
data
array
An array of file objects.
has_more
boolean
Indicates whether there are more files available beyond this page.

Return Examples

Response 200
{
  "object": "list",
  "data": [
    {
      "id": "file-abc123",
      "object": "file",
      "bytes": 120000,
      "created_at": 1699564800,
      "filename": "batch_requests.jsonl",
      "purpose": "batch",
      "status": "uploaded",
      "status_details": null
    },
    {
      "id": "file-def456",
      "object": "file",
      "bytes": 85000,
      "created_at": 1699564700,
      "filename": "training_data.jsonl",
      "purpose": "fine-tune",
      "status": "uploaded",
      "status_details": null
    }
  ],
  "has_more": false
}
Response 200 - Empty List
{
  "object": "list",
  "data": [],
  "has_more": false
}
Last modified on December 7, 2025