List Files

GET /v1/files

List Files

cURL

curl --request GET \
  --url https://api.neosantara.xyz/v1/files \
  --header 'x-api-key: <api-key>'

200

{
  "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.

Show file object properties

id · string

The unique identifier of the file.

object · string

The object type, always file.

bytes · integer

The size of the file in bytes.

created_at · integer

The Unix timestamp 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 status details.

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
}