List messages by mail account
Returns messages sent or scheduled from a specific mail account. Useful for monitoring cold outreach campaigns — check pending queue, delivery history, and plan next sends. Only returns outbound messages (sent and scheduled), not received.
Request
- Base URL: https://api.100hires.com/v2
- URL: https://api.100hires.com/v2/messages
- Auth: HTTP bearer
Query parameters
ID of the mail account (from GET /companies/mail-accounts or GET /users/{user_id}/mail-accounts).
Filter by message status: scheduled (pending send), sent (delivered), all (both). Default: all.
Start of period (unix timestamp, seconds). Filters on scheduled/sent time.
End of period (unix timestamp, seconds). Filters on scheduled/sent time.
Page number (1-based).
Number of items per page (1–100).
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.
Response
Paginated list of messages for the specified mail account.
Changes
No recorded changes to this operation across all 1 revision of this API.