> ## Documentation Index
> Fetch the complete documentation index at: https://docs.novita.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List files

Displays a list of all available files.

## Request Headers

**Content-Type** `string` *required*

Enum: `application/json`

**Authorization** `string` *required*

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

## Response

**code** `string` *required*

HTTP status code indicating the result of the request.

**message** `string` *required*

A descriptive message about the request result.

**data** `object[]` *required*

An array of file objects.

**File Object Properties**

**id** `string` *required*

The unique identifier of the file.

**object** `string` *required*

The object type, which is always `file`.

**bytes** `integer` *required*

The size of the file in bytes.

**filename** `string` *required*

The name of the file.

**created\_at** `integer` *required*

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

**expires\_at** `integer`

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

**purpose** `string` *required*

The purpose of the file.

Available purposes:

* `batch` - Input file for batch processing
* `batch_output` - Output file from batch processing

**metadata** `object` *required*

Additional metadata about the file.

**properties**

**total\_requests** `integer`

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.