---
title: "Get a list of sms sent"
method: GET
path: "/sms/list"
tags: ["Sms"]
---

# Get a list of sms sent

`GET /sms/list`

Retrieve a list of sms sent between two date.

## Query parameters

- `from` string
- `to` string
- `page` number
- `perPage` number

## Headers

- `ApiKey` string, required
- `MerchantId` string, required
- `Environment` 'live' | 'sandbox', required

## Response `200`

- SmsDto[]
  - `id` string, required — unique identifier for the sms.
  - `senderId` string, required — Identifier of the merchant that send the sms
  - `senderName` string, required — name of the merchant that send the sms
  - `destination` string, required — Number of the recipient with country code (+44...) or in international format (0044 ...)
  - `smsCount` number, required — Number of Sms sent , depending on the message length (1 sms per 160 character)
  - `message` string, required — Message content
  - `status` string, required — Status of the sms
  - `createdAt` string, required — Datetime in UTC timezone at which the sms was created. Follows the[Datetime ISO](https://en.wikipedia.org/wiki/ISO_8601).
  - `sentAt` string, required — Datetime in UTC timezone at which the sms was sent. Follows the[Datetime ISO](https://en.wikipedia.org/wiki/ISO_8601).
  - `receivedAt` string, required — Datetime in UTC timezone at which the sms was received. Follows the[Datetime ISO](https://en.wikipedia.org/wiki/ISO_8601).
  - `failureCause` SmsFailureCauseDto, required

## Other responses

- `401` — Wrong credentials
- `500` — Internal error

---

[API](https://skmtc.net/hub2/apis/hub2-service-api.md) · [All operations](https://skmtc.net/hub2/apis/hub2-service-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hub2/hub2-service-api/versions/adb17b4b80f4/schema)