API reference›Files

List Files

GET /v1/files View .md

The account's uploaded files that have not expired, newest first.

Query parameters

limit integer

default 1000range 1–1000

Responses

application/json · list-files-response-payload

3 fields

object string

list
data array of objects
9 fields
- id string
- object string
  
  file
- bytes integer
- created_at integer
  
  Unix seconds.
- expires_at integer
  
  Unix seconds; 30 days after upload. The file and its text are gone after.
- filename string
- purpose string
  
  As uploaded; user_data when none was given. Any purpose can be referenced.
- status string
  
  processed once the file can be referenced by file_id.
  
  processingprocessederror
- status_details string or null
  
  Why the file is in error, for example The PDF has 301 pages; the limit is 300.
has_more boolean

curl https://api.vultrinference.com/v1/files \
  -H "Authorization: Bearer $VULTR_INFERENCE_API_KEY"

import os
import requests

response = requests.get(
    "https://api.vultrinference.com/v1/files",
    headers={"Authorization": f"Bearer {os.environ['VULTR_INFERENCE_API_KEY']}"},
)
print(response.json())

const response = await fetch("https://api.vultrinference.com/v1/files", {
  headers: {
    Authorization: `Bearer ${process.env.VULTR_INFERENCE_API_KEY}`,
  },
});
console.log(await response.json());

Response · 200

{
    "object": "list",
    "data": [
        {
            "id": "file-6f1d2c9a4b7e8f0a1c2d3e4f",
            "object": "file",
            "bytes": 0,
            "created_at": 1790000000,
            "expires_at": 1790000000,
            "filename": "string",
            "purpose": "string",
            "status": "processing",
            "status_details": "string"
        }
    ],
    "has_more": false
}