List and retrieve documents

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.

/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
}

Signed in, you can list the first page of your own documents from here:

To walk every page, loop until hasMore is false, passing the previous response's nextCursor each time, with the same sort and direction:

curl "https://nordvec.com/api/v1/documents/list?limit=50&cursor=eyJrIjoi…" \
  -H "Authorization: Bearer $NORDVEC_API_KEY"

All filters are optional and combine with AND. Sorting defaults to newest first.

curl "https://nordvec.com/api/v1/documents/list?status=indexed&datasource=finance&sort=updatedAt&direction=desc&limit=100" \
  -H "Authorization: Bearer $NORDVEC_API_KEY"

Which sort to walk withCopy link to this heading

• A complete, one-shot enumeration: sort=createdAt. The creation time never changes, so every document appears exactly once.
• Incremental catch-up from a watermark: sort=updatedAt&direction=asc. A document updated while you walk can appear twice, so upsert by id.
• Display order: updatedAt or title descending. A document updated between two pages can move past the cursor and be skipped, so do not use it to enumerate.

/documents/{id} returns one document's metadata, processing state and text. A long text can be read in windows: contentOffset and contentMaxChars (counted in UTF-16 code units) select one window, and content_range reports the window and the full length, so keep reading until offset + length reaches total.

curl "https://nordvec.com/api/v1/documents/DOCUMENT_ID?contentMaxChars=100000" \
  -H "Authorization: Bearer $NORDVEC_API_KEY"

To resolve up to 200 ids in one call, POST them to /documents/batch instead of making one request per id. The batch returns metadata and processing state; content is always null, so read the text with the single-document call.

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"] }'