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

# Get incoming messages

`GET /streams/incoming_messages`

List incoming (inbound) messages for your account, newest first. Supports pagination and filtering by stream, sender, destination, and date range.

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

## Query parameters

- `streamId` integer
- `phone` string
- `destination` string
- `startDate` string
- `endDate` string
- `page` integer
- `itemsPerPage` integer

## Response `200`

A page of incoming messages.

- object
  - `items` object[] — The page of results.
    - `message_uuid` string — Unique message identifier.
    - `received_at` string — When the message was received (UTC).
    - `from` string — Sender phone number.
    - `to` string — Recipient (your) number or sender ID.
    - `contact_name` string — Resolved contact name, if known.
    - `country_code` string — Sender country dialing code.
    - `country_iso2` string — Sender country ISO-3166 alpha-2 code.
    - `country_name` string — Sender country name.
    - `body` string — Message text.
    - `message_length` integer — Length of the message body.
    - `conversation` string — Conversation identifier.
    - `stream` string — Stream identifier.
  - `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)