Liste opp og hente dokumenter
Gå gjennom dokumentene dine med markørpaginering, filtrer og sorter dem, og hent ett eller flere etter id.
Der søk rangerer dokumenter etter relevans til en spørring, mens listing går gjennom hele korpuset ditt i rekkefølge. Bruk den til å synkronisere, revidere eller bygge ditt eget indeks over hva Nordvec inneholder. Listing returnerer kun metadata, ikke dokumentinnhold.
List med markørpaginering
/documents/list returnerer en side med dokumenter pluss en ugjennomsiktig nextCursor. Send
denne markøren tilbake for å få neste side, og stopp når hasMore er 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
}For å gå gjennom alle sider, loop til hasMore er false, og send med forrige
respons sin nextCursor hver gang:
curl "https://nordvec.com/api/v1/documents/list?limit=50&cursor=eyJrIjoi…" \
-H "Authorization: Bearer $NORDVEC_API_KEY"Markøren er ugjennomsiktig, ikke analyser eller konstruer den. Send tilbake nøyaktig det forrige svaret returnerte. En manipulert markør avvises.
Filtrer og sorter
Alle filtre er valgfrie og kombineres med AND. Sortering er som standard nyeste først.
| Felt | Type | Merknader |
|---|---|---|
limit | heltall | 1 til 200 (standard 50). |
cursor | streng | Ugjennomsiktig markør fra forrige side. |
datasource | streng | Begrens til én datakilde. |
status | enum | indexed, processing eller failed. |
sourceProvider | streng | Begrens til én tilkoblingsleverandør. |
createdAfter / createdBefore | streng | ISO 8601-tidspunkt. |
sort | enum | createdAt (standard), updatedAt eller title. |
direction | enum | desc (standard) eller 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"Hent ett enkelt dokument
/documents/{id} returnerer ett dokuments fulle detaljer (ikke bare listemetadata). Bruk den etter at du har en id fra en liste eller søkeresultat.
curl https://nordvec.com/api/v1/documents/DOCUMENT_ID \
-H "Authorization: Bearer $NORDVEC_API_KEY"Hent mange på en gang
For å løse opp et sett med id-er i én kall, POST dem til /documents/batch i stedet for
å gjøre én forespørsel 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, som søk, returnerer kun dokumenter du har tilgang til å se, og en
status på processing eller failed betyr at dokumentet ikke er hentbart ennå.
Se Dokumenter og søk for livssyklusen.