List and retrieve documents
Page through your documents with cursor pagination, filter and sort them, and fetch one or many by id.
Where search ranks documents by relevance to a query, listing walks your whole corpus in order. Use it to sync, audit, or build your own index over what Nordvec holds. Listing returns metadata only, no document content.
List with cursor pagination
/documents/list returns a page of documents plus an opaque nextCursor. Pass
that cursor back to get the next page, and stop when hasMore is false.
curl "https://nordvec.com/api/v1/documents/list?limit=50" \
-H "Authorization: Bearer $NORDVEC_API_KEY"{
"items": [
{ "id": "…", "title": "Q3 Financial Report", "status": "indexed", "datasource": "finance", "created_at": "2026-04-01T10:00:00Z" }
],
"nextCursor": "eyJrIjoi…",
"hasMore": true
}To walk every page, loop until hasMore is false, passing the previous
response's nextCursor each time:
curl "https://nordvec.com/api/v1/documents/list?limit=50&cursor=eyJrIjoi…" \
-H "Authorization: Bearer $NORDVEC_API_KEY"The cursor is opaque, do not parse or construct it. Pass back exactly what the previous response returned. A tampered cursor is rejected.
Filter and sort
All filters are optional and combine with AND. Sorting defaults to newest first.
| Field | Type | Notes |
|---|---|---|
limit | integer | 1 to 200 (default 50). |
cursor | string | Opaque cursor from the previous page. |
datasource | string | Restrict to one datasource. |
status | enum | indexed, processing, or failed. |
sourceProvider | string | Restrict to one connector provider. |
createdAfter / createdBefore | string | ISO 8601 timestamps. |
sort | enum | createdAt (default), updatedAt, or title. |
direction | enum | desc (default) or asc. |
curl "https://nordvec.com/api/v1/documents/list?status=indexed&datasource=finance&sort=updatedAt&direction=desc&limit=100" \
-H "Authorization: Bearer $NORDVEC_API_KEY"Fetch a single document
/documents/{id} returns one document's full detail (not just the list
metadata). Use it after you have an id from a list or search result.
curl https://nordvec.com/api/v1/documents/DOCUMENT_ID \
-H "Authorization: Bearer $NORDVEC_API_KEY"Fetch many at once
To resolve a set of ids in one call, POST them to /documents/batch instead of
making one request per id.
curl https://nordvec.com/api/v1/documents/batch \
-H "Authorization: Bearer $NORDVEC_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "ids": ["DOCUMENT_ID_1", "DOCUMENT_ID_2"] }'Listing, like search, only ever returns documents you are allowed to see, and a
status of processing or failed means the document is not yet retrievable.
See Documents & search for the lifecycle.