Get one candidate's status

GET 
/api/v1/cvds/candidates/:external_id

Return one candidate's embedding status (plus its tags). Like the list endpoint, the candidate's parsed_cv is never returned — you already hold it. A candidate that doesn't exist in the named corpus, or belongs to another client, returns 404 (no existence leak).

Request

Responses

200

The candidate's status.

401

Missing or invalid API key.

403

Authenticated but missing the cvdeepsearch permission.

404

No candidate with this external_id in the named corpus for your client. Also returned cross-tenant to avoid leaking the existence of other clients' candidates.