---
title: "Get Your Messages"
method: GET
path: "/v1/messages"
tags: ["Messages"]
---

# Get Your Messages

`GET /v1/messages`

## Query parameters

- `page_size` string — Default value is 10, can be at maximum 1000
- `page_token` string — Found in pagination links and can be used to get 'previous' or 'next' items
- `filter[countries]` string[]
- `filter[sender_ids]` string[]
- `filter[created_date_start]` string, date-time
- `filter[created_date_end]` string, date-time
- `filter[statuses]` EnumMessageStatuses[]
- `filter[to]` string
- `filter[from]` string
- `filter[to_prefix]` string
- `filter[channel]` 'SMS' | 'VIBER' | 'WHATSAPP'
- `filter[campaign_ids]` string[]

## Response `200`

OK

- MessageResponseListWrapperDto
  - `data` object[]
    - `id` string, uuid — Unique identifier of the message
    - `account_id` string, uuid — Unique identifier of the account
    - `from` string — Identifier of the sender(name)
    - `to` string — Recipients phone number
    - `channel` 'SMS' | 'VIBER' | 'WHATSAPP' — Delivery channel of the message. Enumeration values [SMS, VIBER, WHATSAPP]
    - `status` 'delivered' | 'sent' | 'failed' | 'enroute' | 'read' | 'rejected' | 'unsubscribed' | 'expired' | 'blocked' — Message status. Enumeration values [delivered, sent, failed, enroute, read, rejected, unsubscribed, expired, blocked]
    - `text` string — Text of the message
    - `button` object
      - `type` string — Button type of the message
      - `text` string — Button text of the message
      - `value` string — Button value of the message
      - `button_variables` string[] — Dynamic URL segment values for call_to_action buttons.
    - `create_date` string, date-time — Creation date of the message in UTC, formatted as yyyy-mm-dd hh:mm:ss
    - `update_date` string, date-time — Update date of the message in UTC, formatted as yyyy-mm-dd hh:mm:ss
    - `segment_count` integer — The count of message parts for [SMS] Channel, other channel messages are always in 1 segment
    - `encoding` string — Encoding of the [SMS] message. Enumeration Values [GSM-7, UCS-2]
    - `country` string — ISO code of the recipients number
    - `price` number — Amount charged for the message in accounts currency
  - `pagination` Pagination
    - `number` integer — Current page number
    - `size` integer — Page size. Default value is 10, can be at maximum 1000
    - `total` integer — Total count of requested resources
    - `links` object — Contains URLs to get next/previous resources
      - `first` string — URL to the first page
      - `current` string — URL to the current page
      - `previous` string — URL to the previous page, if any
      - `next` string — URL to the next page, if any

## Other responses

- `400` — **Bad Request:** Code Message Description 1521 Wrong date format Date format should be in yyyy-MM-dd HH:mm:ss

---

[API](https://skmtc.net/dexatel/apis/verify-apis.md) · [All operations](https://skmtc.net/dexatel/apis/verify-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dexatel/verify-apis/revisions/a924257f431d/schema)