List Files

GET/v1/files

Authorization

Authorizationstringrequired

Bearer token for API authentication. Format: `Bearer YOUR_API_KEY`

Query Parameters

limitintegerdefault: 20

Maximum number of items to return per page (1-100)

Constraints

•Minimum: 1•Maximum: 100

afterstring

Cursor for forward pagination - get items after this position. Use last_cursor from previous response.

beforestring

Cursor for backward pagination - get items before this position. Use first_cursor from previous response.

include_totalbooleandefault: false

Whether to include total count in response (expensive operation)

qstring

Search query for fuzzy matching over name and description fields

Response Body

objectstringdefault: list

The object type of the response

Request

GET/v1/files

from mixedbread import Mixedbread

mxbai = Mixedbread(api_key="YOUR_API_KEY")

files = mxbai.files.list(limit=20)

for file in files.data:
    print(file.id, file.filename)

Response

JSON

{
  "object": "list",
  "data": [
    {
      "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "filename": "document.pdf",
      "bytes": 1048576,
      "mime_type": "application/pdf",
      "version": 1,
      "created_at": "2025-01-15T10:00:00.000Z",
      "updated_at": "2025-01-15T10:00:00.000Z",
      "object": "file"
    },
    {
      "id": "b2c3d4e5-f6a7-8901-bcde-f23456789012",
      "filename": "report.docx",
      "bytes": 524288,
      "mime_type": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
      "version": 1,
      "created_at": "2025-01-14T15:30:00.000Z",
      "updated_at": "2025-01-14T15:30:00.000Z",
      "object": "file"
    }
  ],
  "pagination": {
    "has_more": false,
    "first_cursor": "eyJpZCI6ImZpbGVfYWJjMTIzIn0=",
    "last_cursor": "eyJpZCI6ImZpbGVfZGVmNDU2In0="
  }
}