Mixedbread

List Store Files

List files indexed in a store with pagination and metadata filter.

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

Authorization

ApiKeyAuth
headerAuthorizationBearer <token>

Api key to access Mixedbreads API

Path Parameters

store_identifier*|

The ID or name of the store

Request Body

application/json
  1. body

For pagination

limit?Limit

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

Range1 <= value <= 100
Default20
after?|

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

before?|

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

include_total?Include Total

Whether to include total count in response (expensive operation)

Defaultfalse
sort_by?Sort By

Field to order the files by

Default"created_at"
Value in"created_at""filename""usage_bytes""usage_tokens"
sort_order?Sort Order

Direction of the sort

Default"desc"
Value in"asc""desc"
statuses?array<>|

Status to filter by

metadata_filter?||array<|>|

Metadata filter to apply to the query

q?|

Search query for fuzzy matching over name and external_id fields

Response Body

List of files in the store

application/json
  1. response
pagination*

Response model for cursor-based pagination.

object?Object

The object type of the response

Default"list"
data*array<>

The list of store files

from mixedbread import Mixedbreadmxbai = Mixedbread(api_key="YOUR_API_KEY")response = mxbai.stores.files.list("my-knowledge-base", limit=20)for file in response.data:    print(file)
{  "object": "list",  "data": [    {      "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",      "external_id": "ext-doc-001",      "object": "store.file",      "filename": "example_document.pdf",      "status": "completed",      "last_error": null,      "store_id": "c3d4e5f6-a7b8-9012-cdef-345678901234",      "usage_bytes": 1048576,      "usage_tokens": 51200,      "config": {        "parsing_strategy": "fast"      },      "version": 1,      "created_at": "2025-01-15T14:00:00.000Z",      "content_url": "https://example.com/files/f47ac10b-58cc-4372-a567-0e02b2c3d479?signature=...",      "metadata": {        "category": "documentation",        "author": "John Doe"      }    },    {      "id": "b2c3d4e5-f6a7-8901-bcde-f23456789012",      "external_id": "ext-doc-001",      "object": "store.file",      "filename": "api_reference.pdf",      "status": "completed",      "last_error": null,      "store_id": "c3d4e5f6-a7b8-9012-cdef-345678901234",      "usage_bytes": 524288,      "usage_tokens": 51200,      "config": {        "parsing_strategy": "fast"      },      "version": 1,      "created_at": "2025-01-15T15:00:00.000Z",      "content_url": "https://example.com/files/b2c3d4e5-f6a7-8901-bcde-f23456789012?signature=...",      "metadata": {        "category": "documentation",        "author": "Jane Smith"      }    }  ],  "pagination": {    "has_more": false,    "first_cursor": "eyJpZCI6ImZpbGVfYWJjMTIzIn0=",    "last_cursor": "eyJpZCI6ImZpbGVfZGVmNDU2In0="  }}