Elenca e recupera i documenti
Scorri i tuoi documenti con la paginazione tramite cursore, filtrali e ordinali, e recuperane uno o molti tramite id.
Dove la ricerca classifica i documenti in base alla rilevanza rispetto a una query, il listing scorre tutto il tuo corpus in ordine. Usalo per sincronizzare, verificare o creare il tuo indice su ciò che Nordvec contiene. Il listing restituisce solo metadati, non il contenuto dei documenti.
Listing con paginazione tramite cursore
/documents/list restituisce una pagina di documenti più un nextCursor opaco. Passa
quel cursore per ottenere la pagina successiva e fermati quando hasMore è 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
}Per scorrere ogni pagina, esegui un ciclo finché hasMore è false, passando ogni volta
il nextCursor della risposta precedente:
curl "https://nordvec.com/api/v1/documents/list?limit=50&cursor=eyJrIjoi…" \
-H "Authorization: Bearer $NORDVEC_API_KEY"Il cursore è opaco, non analizzarlo o costruirlo. Passa esattamente ciò che la risposta precedente ha restituito. Un cursore manomesso viene rifiutato.
Filtri e ordinamento
Tutti i filtri sono opzionali e si combinano con AND. L'ordinamento predefinito è dal più recente.
| Campo | Tipo | Note |
|---|---|---|
limit | integer | Da 1 a 200 (predefinito 50). |
cursor | string | Cursore opaco della pagina precedente. |
datasource | string | Limita a una singola datasource. |
status | enum | indexed, processing o failed. |
sourceProvider | string | Limita a un singolo provider di connettori. |
createdAfter / createdBefore | string | Timestamp ISO 8601. |
sort | enum | createdAt (predefinito), updatedAt o title. |
direction | enum | desc (predefinito) o 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"Recupera un singolo documento
/documents/{id} restituisce il dettaglio completo di un documento (non solo i metadati del listing).
Usalo dopo aver ottenuto un id da un risultato di listing o ricerca.
curl https://nordvec.com/api/v1/documents/DOCUMENT_ID \
-H "Authorization: Bearer $NORDVEC_API_KEY"Recupera più documenti in una volta
Per risolvere un insieme di id con una singola chiamata, inviali tramite POST a /documents/batch invece di
effettuare una richiesta per ogni 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"] }'Il listing, come la ricerca, restituisce solo i documenti che sei autorizzato a vedere, e un
status di processing o failed indica che il documento non è ancora recuperabile.
Consulta Documenti e ricerca per il ciclo di vita.