# List files - Documentation

> For the complete documentation index, see [llms.txt](/llms.txt). Markdown is available with `Accept: text/markdown` and `.md` URL variants.

Source: /docs/api-reference/model-apis-llm-list-files

# List files

GET

/

openai

/

v1

/

files

Try it

List files

cURL

```
curl --request GET \
--url https://api.novita.ai/openai/v1/files \
--header 'Authorization: ' \
--header 'Content-Type: '
```

200

```
{
"code": "",
"message": "",
"data": [
{
"id": "",
"object": "",
"bytes": 123,
"filename": "",
"created_at": 123,
"expires_at": 123,
"purpose": "",
"metadata": {
"total_requests": 123
}
}
]
}
```

Displays a list of all available files.

##

[​](#request-headers)

Request Headers

[​](#param-content-type)

Content-Type

string

required

Enum: `application/json`

[​](#param-authorization)

Authorization

string

required

Bearer authentication format, for example: Bearer {{API Key}}.

##

[​](#response)

Response

[​](#param-code)

code

string

required

HTTP status code indicating the result of the request.

[​](#param-message)

message

string

required

A descriptive message about the request result.

[​](#param-data)

data

array

required

An array of file objects.

Show File Object Properties

[​](#param-id)

id

string

required

The unique identifier of the file.

[​](#param-object)

object

string

required

The object type, which is always `file`.

[​](#param-bytes)

bytes

integer

required

The size of the file in bytes.

[​](#param-filename)

filename

string

required

The name of the file.

[​](#param-created-at)

created_at

integer

required

The Unix timestamp (in seconds) when the file was created.

[​](#param-expires-at)

expires_at

integer

The Unix timestamp (in seconds) when the file will expire. Only present for output files.

[​](#param-purpose)

purpose

string

required

The purpose of the file.Available purposes:

- `batch` - Input file for batch processing

- `batch_output` - Output file from batch processing

[​](#param-metadata)

metadata

object

required

Additional metadata about the file.

Show properties

[​](#param-total-requests)

total_requests

integer

The total number of requests in the batch input file. Only present for batch input files.

Last modified on August 12, 2025