Get a candidate's activity timeline

Returns a unified, cursor-paginated activity stream for a candidate, merging stage changes, calls, SMS, emails, interview events, and notes.

AuthorizationBearer

Supabase-issued user JWT. Send as Authorization Bearer header. Dedicated API keys are planned for a future release.

candidateIdstringRequiredformat: "uuid"

typesstringOptional

Comma-separated event types to include (comm, stage, interview, override, note).

actor_idstringOptionalformat: "uuid"

Only events performed by this user.

sincedatetimeOptional

Only events at or after this timestamp (ISO 8601).

cursorstringOptional

Opaque pagination cursor from a previous response.

limitintegerOptional<=100Defaults to 30

Page size (default 30, max 100).

Timeline page.

eventslist of objectsOptional

next_cursorstring or nullOptional

Pass as the cursor query parameter to fetch the next page. Null when no more events.

401

Unauthorized Error

404

Not Found Error