Skip to main content
GET
/
v1
/
files
List files
curl --request GET \
  --url https://api.zerogpu.ai/v1/files \
  --header 'x-api-key: <api-key>' \
  --header 'x-project-id: <api-key>'
{
  "data": [
    {
      "id": "<string>",
      "bytes": 123,
      "created_at": 123,
      "filename": "<string>",
      "status_details": "<string>",
      "expires_at": 123,
      "is_error": true
    }
  ],
  "first_id": "<string>",
  "last_id": "<string>",
  "has_more": true
}

Documentation Index

Fetch the complete documentation index at: https://docs.zerogpu.ai/llms.txt

Use this file to discover all available pages before exploring further.

List files for your project. Filter with purpose=batch (uploads) or purpose=batch_output (batch results; check is_error on each item for error files). Use last_id from the response as after on the next request to page. Full reference: Files API.

Authorizations

​
x-api-key
string
header
required
​
x-project-id
string
header
required

Query Parameters

​
purpose
enum<string>

Filter by purpose. batch_output includes success and error output files (is_error on each object).

Available options:
batch,
batch_output
​
order
enum<string>
default:desc
Available options:
desc,
asc
​
after
string

Cursor: file id from the previous page (or last_id from the prior response).

​
limit
integer
default:10000
Required range: 1 <= x <= 10000

Response

File list

​
object
enum<string>
Available options:
list
​
data
object[]
​
first_id
string | null
​
last_id
string | null
​
has_more
boolean