Skip to main content
POST
List chunks
Return a paginated list of chunks from a vector database. Filter by file_id, by specific chunk_ids, or by user-defined metadata fields. Metadata filters use the same operator syntax as file search filters ($in, $gt, $gte, $lt, $lte), and multiple filters are combined with AND. Each chunk in the response includes its text, metadata, heading hierarchy, and source locations.

Authorizations

Authorization
string
header
required

Your Seekr API key, sent in the Authorization header with no 'Bearer' prefix.

Path Parameters

database_id
string
required

Body

application/json

Request body for searching/listing chunks in a vector database.

file_id
string | null

Filter to chunks from a specific file

chunk_ids
string[] | null

Chunk IDs to retrieve

metadata
Metadata · object | null

Metadata key-value filters with optional operators ($gt, $gte, $lt, $lte, $in). Example: {"year": {"$gte": 2023}, "doc_type": "SOP"}

limit
integer
default:20

Max results to return

Required range: 1 <= x <= 100
offset
integer
default:0

Pagination offset

Required range: x >= 0

Response

Success

data
VectorDatabaseChunkListItem · object[]
required
total
integer
required
limit
integer
required
offset
integer
required
object
string
default:list
Allowed value: "list"
Last modified on June 25, 2026