# List and retrieve documents
Source: https://nordvec.com/docs/guides/how-to/list-documents#fetch-many-at-once

## Fetch many at once [#fetch-many-at-once]

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.

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

<Callout>
Listing, like search, only ever returns documents the caller is allowed to see.
`status` tells you where a document is in processing: `processing` while it is
still being indexed, `failed` when it could not be. See
[Documents & search](/docs/guides/concepts/documents) for the lifecycle.
</Callout>