---
title: "Changes to Get incoming messages"
method: GET
path: "/streams/incoming_messages"
---

# Changes to Get incoming messages

`GET /streams/incoming_messages`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 2 revisions.

- **2026-11-03** `5012671cf95d`: 13 breaking, 3 warning, 24 info

## Changes

- **2026-11-03** `5012671cf95d`: 13 breaking, 3 warning, 24 info
  - for the `query` request parameter `itemsPerPage`, default value `30` was added
  - for the `query` request parameter `page`, default value `1` was added
  - response property `items/items/contact_name` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `items/items/country_code` list-of-types was widened by adding types `integer and null` to media type `application/json` of response `200`
  - response property `items/items/country_iso2` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `items/items/country_name` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `items/items/from` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `items/items/message_uuid` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `items/items/received_at` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `items/items/to` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - the `items/items/conversation` response's property type changed from `string` to no type for status `200`
  - the `items/items/stream` response's property type changed from `string` to no type for status `200`
  - the `total` response's property type changed from `integer` to no type for status `200`
  - deleted the `query` request parameter `destination`
  - removed the optional property `items/items/body` from the response with the `200` status
  - removed the optional property `items/items/message_length` from the response with the `200` status
  - api operation id `getIncomingMessages` removed and replaced with `list_incoming_messages`
  - the endpoint scheme security `APIKeyHeader` was added to the API
  - `query` request parameter `endDate` list-of-types was widened by adding types `null`
  - `query` request parameter `itemsPerPage` list-of-types was widened by adding types `null`
  - `query` request parameter `page` list-of-types was widened by adding types `null`
  - `query` request parameter `phone` list-of-types was widened by adding types `null`
  - `query` request parameter `startDate` list-of-types was widened by adding types `null`
  - `query` request parameter `streamId` list-of-types was widened by adding types `null`
  - for the `query` request parameter `endDate`, the type was generalized from `string` to no type
  - for the `query` request parameter `itemsPerPage`, the type was generalized from `integer` to no type
  - for the `query` request parameter `page`, the type was generalized from `integer` to no type
  - for the `query` request parameter `phone`, the type was generalized from `string` to no type
  - for the `query` request parameter `startDate`, the type was generalized from `string` to no type
  - for the `query` request parameter `streamId`, the type was generalized from `integer` to no type
  - added the non-success response with the status `401`
  - added the non-success response with the status `403`
  - added the non-success response with the status `422`
  - added the optional property `items/items/content` to the response with the `200` status
  - added the optional property `items/items/message_type` to the response with the `200` status
  - added the optional property `items/items/type` to the response with the `200` status
  - added `#/components/schemas/MessageConversation, subschema #2` to the `items/items/conversation` response property `anyOf` list for the response status `200`
  - added `#/components/schemas/MessageStream, subschema #2` to the `items/items/stream` response property `anyOf` list for the response status `200`
  - added `subschema #1, subschema #2` to the `total` response property `anyOf` list for the response status `200`
  - the response property `items` became required for the status `200`

---

[Operation](https://skmtc.dev/commpeak/apis/dialer-api-v2-0-1/docs/streams/incoming_messages/get.md) - [API](https://skmtc.dev/commpeak/apis/dialer-api-v2-0-1.md) - [Page](https://skmtc.dev/commpeak/apis/dialer-api-v2-0-1/changes/streams/incoming_messages/get)