Documenten bekijken en ophalen

Terwijl search documenten rangschikt op relevantie voor een query, doorloopt listing je volledige corpus in volgorde. Gebruik het om te synchroniseren, te controleren of je eigen index op te bouwen over wat Nordvec bevat. Listing retourneert alleen metadata, geen documentinhoud.

Listing met cursor-paginering

/documents/list retourneert een pagina met documenten plus een ondoorzichtige nextCursor. Geef die cursor terug om de volgende pagina te krijgen, en stop wanneer hasMore false is.

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
}

Om elke pagina te doorlopen, blijf je herhalen totdat hasMore false is, waarbij je elke keer de nextCursor van het vorige antwoord doorgeeft:

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

Filteren en sorteren

Alle filters zijn optioneel en combineren met AND. Sorteren is standaard op nieuwste eerst.

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

Een enkel document ophalen

/documents/{id} retourneert de volledige details van één document (niet alleen de metadata van de lijst). Gebruik het nadat je een id hebt uit een lijst of zoekresultaat.

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

Meerdere tegelijk ophalen

Om een set ids in één aanroep op te lossen, stuur je ze met POST naar /documents/batch in plaats van voor elke id een apart verzoek te doen.

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

Volgende stappen