---
title: "GET /v1/apps/{application-id}/channels/sms"
method: GET
path: "/v1/apps/{application-id}/channels/sms"
---

# GET /v1/apps/{application-id}/channels/sms

`GET /v1/apps/{application-id}/channels/sms`

Retrieves information about the status and settings of the SMS channel for an application.

## Path parameters

- `application-id` string, required

## Response `200`

Success

- GetSmsChannelResponse
  - `SMSChannelResponse` SMSChannelResponse, required — Provides information about the status and settings of the SMS channel for an application.
    - `ApplicationId` string — The unique identifier for the application that the SMS channel applies to.
    - `CreationDate` string — The date and time, in ISO 8601 format, when the SMS channel was enabled.
    - `Enabled` boolean — Specifies whether the SMS channel is enabled for the application.
    - `HasCredential` boolean — (Not used) This property is retained only for backward compatibility.
    - `Id` string — (Deprecated) An identifier for the SMS channel. This property is retained only for backward compatibility.
    - `IsArchived` boolean — Specifies whether the SMS channel is archived.
    - `LastModifiedBy` string — The user who last modified the SMS channel.
    - `LastModifiedDate` string — The date and time, in ISO 8601 format, when the SMS channel was last modified.
    - `Platform` string, required — The type of messaging or notification platform for the channel. For the SMS channel, this value is SMS.
    - `PromotionalMessagesPerSecond` integer — The maximum number of promotional messages that you can send through the SMS channel each second.
    - `SenderId` string — The identity that displays on recipients' devices when they receive messages from the SMS channel.
    - `ShortCode` string — The registered short code to use when you send messages through the SMS channel.
    - `TransactionalMessagesPerSecond` integer — The maximum number of transactional messages that you can send through the SMS channel each second.
    - `Version` integer — The current version of the SMS channel.

## Other responses

- `480` — BadRequestException
- `481` — InternalServerErrorException
- `482` — PayloadTooLargeException
- `483` — ForbiddenException
- `484` — NotFoundException
- `485` — MethodNotAllowedException
- `486` — TooManyRequestsException

---

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