## List

**get** `/api/v2/messages`

Retrieve a list of messages for the authenticated account with comprehensive filtering capabilities.
Rate limited to 100 requests per 10 seconds per account.

### Returns

- **data:** `array of object`

  - **accountEmail:** `string`

    Email of the account

  - **content:** `string`

    Message content

  - **date\_sent:** `string`

    When the message was sent

  - **date\_updated:** `string`

    When the message was last updated

  - **error\_code:** `number`

    Numeric error code if message failed

  - **error\_detail:** `string`

    Detailed error information

  - **error\_message:** `string`

    Error message if message failed

  - **error\_reason:** `string`

    Error reason if message failed

  - **from\_number:** `string`

    Sender phone number

  - **group\_display\_name:** `string`

    Display name for group messages

  - **group\_id:** `string`

    Group ID for group messages

  - **is\_outbound:** `boolean`

    Whether this is an outbound message

  - **media\_url:** `string`

    URL of attached media

  - **message\_handle:** `string`

    Unique message identifier

  - **message\_type:** `"message" OR "group"`

    - `"message"`

    - `"group"`

  - **number:** `string`

    Primary phone number (to_number for outbound, from_number for inbound)

  - **opted\_out:** `boolean`

    Whether the recipient has opted out

  - **participants:** `array of string`

    List of participants for group messages

  - **plan:** `string`

    Account plan used for this message

  - **send\_style:** `"celebration" OR "shooting_star" OR "fireworks" OR 10 more`

    The iMessage expressive message style

    - `"celebration"`

    - `"shooting_star"`

    - `"fireworks"`

    - `"lasers"`

    - `"love"`

    - `"confetti"`

    - `"balloons"`

    - `"spotlight"`

    - `"echo"`

    - `"invisible"`

    - `"gentle"`

    - `"loud"`

    - `"slam"`

  - **sendblue\_number:** `string`

    Sendblue phone number used

  - **service:** `"iMessage" OR "SMS"`

    - `"iMessage"`

    - `"SMS"`

  - **status:** `"REGISTERED" OR "PENDING" OR "SENT" OR 7 more`

    - `"REGISTERED"`

    - `"PENDING"`

    - `"SENT"`

    - `"DELIVERED"`

    - `"RECEIVED"`

    - `"QUEUED"`

    - `"ERROR"`

    - `"DECLINED"`

    - `"ACCEPTED"`

    - `"SUCCESS"`

  - **to\_number:** `string`

    Recipient phone number

  - **was\_downgraded:** `boolean`

    Whether the message was downgraded from iMessage to SMS

- **pagination:** `object`

  - **hasMore:** `boolean`

    Whether there are more messages available

  - **limit:** `number`

    Number of messages returned in this request

  - **offset:** `number`

    Number of messages skipped

  - **total:** `number`

    Total number of messages matching the filters

- **status:** `string`