List Store Files

POST/v1/stores/{store_identifier}/files/list

Authorization

Authorizationstringrequired

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

Path Parameters

store_identifierstringrequired

The ID or name of the store

Request Body

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)

statusesStoreFileStatus[]

Status to filter by

Response Body

objectstringdefault: list

The object type of the response

Request

POST/v1/stores/{store_identifier}/files/list

from mixedbread import Mixedbread

mxbai = Mixedbread(api_key="YOUR_API_KEY")

response = mxbai.stores.files.list("my-knowledge-base", limit=20)

for file in response.data:
    print(file)

Response

JSON

{
  "object": "list",
  "data": [
    {
      "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "object": "store.file",
      "filename": "example_document.pdf",
      "status": "completed",
      "last_error": null,
      "store_id": "c3d4e5f6-a7b8-9012-cdef-345678901234",
      "usage_bytes": 1048576,
      "version": 1,
      "created_at": "2025-01-15T14:00:00.000Z",
      "metadata": {
        "category": "documentation",
        "author": "John Doe"
      }
    },
    {
      "id": "b2c3d4e5-f6a7-8901-bcde-f23456789012",
      "object": "store.file",
      "filename": "api_reference.pdf",
      "status": "completed",
      "last_error": null,
      "store_id": "c3d4e5f6-a7b8-9012-cdef-345678901234",
      "usage_bytes": 524288,
      "version": 1,
      "created_at": "2025-01-15T15:00:00.000Z",
      "metadata": {
        "category": "documentation",
        "author": "Jane Smith"
      }
    }
  ],
  "pagination": {
    "has_more": false,
    "first_cursor": "eyJpZCI6ImZpbGVfYWJjMTIzIn0=",
    "last_cursor": "eyJpZCI6ImZpbGVfZGVmNDU2In0="
  }
}