List candidates in a corpus

GET 
/api/v1/cvds/candidates

Paginated status list of the candidates in a corpus, newest first. Cursor-based: pass the previous response's next_cursor back as ?cursor= for the next page. The candidate's parsed_cv (the PII you ingested) is never returned by this endpoint — only the embedding status and content hash.

Request

Responses

200

Page of candidate statuses.

400

Invalid query parameters (bad limit, malformed cursor, …).

401

Missing or invalid API key.

403

Authenticated but missing the cvdeepsearch permission.