files management

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

Request

Base URL
https://api.edenai.run
Auth
HTTP bearer

Query parameters

purposestring nullable

Filter by purpose

pageinteger

Page number (1-indexed)

limitinteger

Maximum number of items per page

Response

Successful Response

totalinteger required

Total number of items

pageinteger required

Current page number

limitinteger required

Items per page

total_pagesinteger required

Total number of pages

Example response

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

Changes

No recorded changes to this operation across all 1 revision of this API.