List candidate messages
Returns paginated email and messaging history for a candidate. Useful for communication timeline and audit trails. Use is_scheduled=1 to filter only scheduled (pending) messages.
Request
- Base URL: https://api.100hires.com/v2
- URL: https://api.100hires.com/v2/candidates/{id}/messages
- Auth: HTTP bearer
Path parameters
Candidate ID (numeric) or alias
Query parameters
Page number (1-based). Defaults to 1.
Number of items per page (1–100). Defaults to 20.
Response shape selector for list endpoints. full (default) returns every field — backward-compatible with pre-existing clients. summary returns a thinned payload designed for agent-friendly list browsing: heavy fields (description HTML, embedded profile answers, full message bodies, embedded relations, etc.) are omitted or replaced with *_preview truncations. Use summary when paging through large result sets and fetch a single record with the corresponding GET /{resource}/{id} endpoint when full data is needed.
When set to 1, returns only scheduled (not yet sent) messages. Useful for auditing pending outreach.
Response
Message list
Changes
No recorded changes to this operation across all 1 revision of this API.