List Files

List uploaded files for the authenticated user.

Optionally filter by purpose. Only returns non-expired files. Results are ordered by creation date (newest first).

GET /v3/upload

List Files

cURL

curl --request GET \
  --url https://api.edenai.run/v3/upload \
  --header 'Authorization: Bearer <token>'

200

{
  "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

200

application/json

Successful Response

Response for listing files with pagination.

items · FileResponse · object[] · required

List of items

Show child attributes

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