---
title: "List messages by mail account"
method: GET
path: "/messages"
tags: ["Messages"]
---

# List messages by mail account

`GET /messages`

## Request

- Base URL: `https://api.100hires.com/v2`
- URL: `https://api.100hires.com/v2/messages`
- Auth: HTTP bearer

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.

## Query parameters

- `from_account_id` integer, required
- `status` 'scheduled' | 'sent' | 'all'
- `date_from` integer
- `date_to` integer
- `page` integer
- `size` integer
- `view` 'full' | 'summary'

## Response `200`

Paginated list of messages for the specified mail account.

- AccountMessageListResponse
  - `messages` ScheduledEmail[], required: Array of messages for the specified mail account. Each item uses the same format as `GET /messages/{id}`.
    - `type` 'mailbox', required: Message channel type for scheduler-backed message endpoints.
    - `message` MailboxMessage, required
      - `id` integer, required: Message ID.
      - `from` string, nullable, required: Sender address.
      - `to` string, required: Recipient address.
      - `cc` string, required: CC recipients.
      - `subject` string, required: Message subject.
      - `body` string: Message body content. Present only when `view=full` (default); omitted entirely when `view=summary` — message bodies can run into tens of KB.
      - `date` string, required: Message date.
      - `attachments` Attachment[]: Message attachments. Present only when `view=full` (default); omitted entirely when `view=summary`.
        - `uuid` string, uuid, required: Unique attachment identifier. Stable across API calls; use in referencing endpoints.
        - `url` string, uri, nullable, required: Absolute download URL (e.g. `https://api.100hires.com/v2/attachments/application/{uuid}/{file_name}`). Hit with `Authorization: Bearer <API_KEY>`.
        - `relative_time` string, required: Human-readable time since upload (e.g. `"2 days ago"`).
        - `file` AttachmentFile, required
          - `is_image` boolean, nullable, required: Whether the file is an image.
          - `orig_file_name` string, required: Original file name.
          - `file_ext` string, required: File extension.
          - `file_type` string, required: File type category.
          - `readable_size` string, required: Human-readable file size.
      - `schedule` union, required
        - ''
        - MailboxSchedule
          - `senderId` integer, nullable, required: Sender mail account ID.
          - `isForceSend` boolean, required: Whether forced to send immediately.
          - `isFailed` boolean, required: Whether send failed.
          - `scheduleSendError` string, nullable, required: Error message on failure.
          - `isScheduled` boolean, required: Whether currently scheduled.
          - `scheduledDay` string, required: Scheduled date.
          - `sendAt` integer, required: Scheduled send time.
          - `humanDatetime` string, required: Human-readable scheduled time.
          - `systemDatetime` string, required: System scheduled time.
      - `opensCount` integer, required: Number of times opened.
      - `opens` MailboxOpenEvent[], required: Array of open tracking events.
        - `label` string, required: Open event label.
      - `autoJobId` union, required
        - integer
        - string
      - `isNurtured` boolean, required: Whether sent via nurture campaign.
  - `pagination` Pagination, required
    - `page_size` integer, required: Items per page.
    - `page_count` integer, required: Total number of pages.
    - `page` integer, required: Current page number.
    - `total_count` integer, required: Total number of items.

## Other responses

- `400`: Validation error
- `403`: Forbidden
- `429`: Too many requests

---

[API](https://skmtc.dev/100hires/apis/100hires-api.md) · [All operations](https://skmtc.dev/100hires/apis/100hires-api/llms.txt) · [OpenAPI document](https://skmtc.dev/100hires/apis/100hires-api/revisions/e63e2d3115f7?raw)