Ceevee
CeeveeDocs
⌘K
DashboardAPI keysSign up

Get started

  • Introduction
  • Authentication
  • Errors
  • Pagination
  • Versioning

Core resources

  • Jobs
  • Scans (CVs)
  • Candidates
  • Pipeline & stages
  • Assessments
  • Applications

Webhooks

  • Overview
  • Events
  • Signatures

Reference

  • Rate limits
  • Idempotency
  • OpenAPI spec
  • Changelog

API Reference

Candidates

Search, read, and comment on candidates across your jobs.

Filtering

  • job_id — restrict to candidates in a single job.
  • status — pending, processing, completed, failed. Mirrors the underlying scan status.

Comment timeline

Comments are append-only, attributed to the API token's actor user, and emit a candidate.commented webhook so external CRMs can stay in sync.

REST endpoints

GET/v1/candidates
Paginated list, filterable by job_id and status.
candidates:read
GET/v1/candidates/{id}
Read a single candidate with full extracted profile.
candidates:read
GET/v1/candidates/{id}/comments
List internal team comments on a candidate.
candidates:read
POST/v1/candidates/{id}/comments
Post a new internal comment.
candidates:write