Skip to main content
GET
/
v3
/
upload
List Files
curl --request GET \
  --url https://api.edenai.run/v3/upload \
  --header 'Authorization: Bearer <token>'
{
  "items": [
    {
      "created_at": "2025-12-08T10:30:00Z",
      "expires_at": "2026-01-07T10:30:00Z",
      "file_id": "550e8400-e29b-41d4-a716-446655440000",
      "file_mimetype": "application/pdf",
      "file_name": "invoice.pdf",
      "file_size": 1048576,
      "metadata": {
        "page_count": 5
      },
      "purpose": "general"
    }
  ],
  "limit": 100,
  "page": 1,
  "total": 25,
  "total_pages": 1
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

purpose
string | null

Filter by purpose

Maximum string length: 50
page
integer
default:1

Page number (1-indexed)

Required range: x >= 1
limit
integer
default:100

Maximum number of items per page

Required range: 1 <= x <= 1000

Response

Successful Response

Response for listing files with pagination.

items
FileResponse · object[]
required

List of items

total
integer
required

Total number of items

page
integer
required

Current page number

limit
integer
required

Items per page

total_pages
integer
required

Total number of pages