---
title: "List sent SMS messages"
method: GET
path: "/api/v1/sms"
tags: ["SMS"]
---

# List sent SMS messages

`GET /api/v1/sms`

## Request

- Base URL: `https://app.didlogic.com`
- URL: `https://app.didlogic.com/api/v1/sms`
- Auth: HTTP bearer

Retrieve paginated list of SMS messages sent by the authenticated user.
Note: Contact your account manager to set up a Relay URL for inbound messages.

`sms[].id` feeds sms_show. Full record: sms_show.

## Query parameters

- `page` string
- `per_page` string

## Response `200`

Successfully returns paginated list of sent SMS messages

- object
  - `pagination` object, required
    - `pages` integer, required
    - `page` integer, required
    - `total_records` integer, required
    - `per_page` integer, required
  - `sms` object[], required: List of SMS messages
    - `id` integer, required: SMS ID
    - `destination` string, required: Destination number
    - `message` string, required: Message content
    - `status` 'created' | 'failed' | 'sent' | 'dlr_error' | 'delivered' | 'not_delivered' | 'interrupted', required: Delivery status
    - `charge` number, float, required: SMS cost
    - `segments_count` integer, required: Number of segments
    - `error_code` integer, nullable, required: Why the SMS failed, as an SMPP command_status; `null` unless `status` is `failed`. A failure with no more specific code reads `255`. - `10` (`ESME_RINVSRCADR`) — Invalid sender ID: the sender ID is not accepted for this destination - `11` (`ESME_RINVDSTADR`) — Invalid destination number: the destination number is not valid - `69` (`ESME_RSUBMITFAIL`) — Submit failed: the message was rejected and not delivered - `255` (`ESME_RUNKNOWNERR`) — Unknown error: the message failed for any other reason
    - `error_description` string, nullable, required: The text for `error_code` ("Invalid sender ID", "Invalid destination number", "Submit failed", "Unknown error"); `null` unless `status` is `failed`.

## Other responses

- `403`: Returns 403 error when API token is incorrect

---

[API](https://skmtc.dev/didlogic/apis/get-started.md) · [All operations](https://skmtc.dev/didlogic/apis/get-started/llms.txt) · [OpenAPI document](https://skmtc.dev/didlogic/apis/get-started/revisions/dc972d592b34?raw)