---
title: "Get messages"
method: GET
path: "/streams/messages"
tags: ["Streams"]
---

# Get messages

`GET /streams/messages`

List sent (outgoing) messages for your account, newest first. Supports pagination and filtering by stream, status, recipient, and date range.

**Authentication:** TextPeak API key in the `Authorization` header (see **Authentication** in the API Overview).

## Query parameters

- `type` string
- `status` string
- `streamId` integer
- `phone` string
- `startDate` string
- `endDate` string
- `page` integer
- `itemsPerPage` integer

## Response `200`

A page of sent messages.

- object
  - `items` object[] — The page of results.
    - `type` string — Message direction.
    - `message_uuid` string — Unique message identifier.
    - `external_key` string — Vendor / external reference.
    - `sent_at` string — When the message was sent (UTC).
    - `delivered_at` string — When delivery was confirmed (UTC), if available.
    - `status` string — Delivery status.
    - `source_number` string — Sender number or ID.
    - `source_name` string — Sender display name.
    - `destination_number` string — Recipient phone number.
    - `country_code` string — Recipient country dialing code.
    - `country_iso2` string — Recipient country ISO-3166 alpha-2 code.
    - `country_name` string — Recipient country name.
    - `cost` number — Message cost.
    - `platform` string — Delivery channel.
    - `content` object — Message content.
      - `type` string — Content type.
      - `body` string — Message body.
    - `conversation` string — Conversation identifier.
    - `stream` string — Stream identifier.
    - `campaign` string — Campaign identifier, if any.
  - `total` integer — Total number of matching records.

---

[API](https://skmtc.net/commpeak/apis/dialer-api-v2-0-1.md) · [All operations](https://skmtc.net/commpeak/apis/dialer-api-v2-0-1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/commpeak/dialer-api-v2-0-1/revisions/eacecf960bb6/schema)