---
title: "Get SMS app by ID"
method: GET
path: "/v1/projects/{projectId}/sms/smsApps/{smsAppId}"
tags: ["SMS Apps"]
---

# Get SMS app by ID

`GET /v1/projects/{projectId}/sms/smsApps/{smsAppId}`

Retrieves a single SMS app by its ID within a project.

## Path parameters

- `projectId` string, required
- `smsAppId` string, required

## Response `200`

SMS app details

- SmsSmsAppDto
  - `id` string, required — SMS App id.
  - `smsServiceId` string, required — Id of the SMS Service which the SMS App belongs to.
  - `name` string, required — Name of SMS App.
  - `status` 'ACTIVE' | 'BLOCKED' | 'DELETED' | 'DEPROVISIONING' | 'DEPROVISIONING_FAILED' | 'FAILED_ADD' | 'FAILED_BLOCK' | 'FAILED_DELETE' | 'FAILED_UNBLOCK' | 'FAILED_UPDATE' | 'IN_PROGRESS_ADD' | 'IN_PROGRESS_BLOCK' | 'IN_PROGRESS_DELETE' | 'IN_PROGRESS_UNBLOCK' | 'IN_PROGRESS_UPDATE' | 'PENDING_ADD' | 'PENDING_BLOCK' | 'PENDING_DELETE' | 'PENDING_UNBLOCK' | 'PENDING_UPDATE' | 'PROVISIONING' | 'PROVISIONING_ADD' | 'PROVISIONING_ADD_FAILED' | 'PROVISIONING_BLOCK' | 'PROVISIONING_BLOCK_FAILED' | 'PROVISIONING_FAILED' | 'PROVISIONING_UNBLOCK' | 'PROVISIONING_UNBLOCK_FAILED' | 'PROVISIONING_UPDATE' | 'PROVISIONING_UPDATE_FAILED' | 'STATUS_UNSPECIFIED' | 'UNRECOGNIZED', required — Status of SMS App.
  - `regions` SmsSmsAppRegionsEnum[], required — List of regions of the app.
  - `conversationApiAppDetails` SmsConversationApiAppDto
    - `id` string, required — ID of the app
    - `projectId` string, required — ID of the app project
    - `region` 'BR' | 'EU' | 'US' | 'UNRECOGNIZED', required — App region.
    - `channelStatus` 'ACTIVE' | 'FAILING' | 'PENDING' | 'UNRECOGNIZED' — Status of the channel credentials integration.
  - `test` boolean, required — True if the app is a test app.

## Other responses

- `401` — Unauthorized
- `404` — NotFound
- `500` — InternalServerError

## Changes

> 4 revisions in range; 1 not diffed.

- **2026-09-01** `c6a937922d10` — 6 breaking, 56 info
  - the response's body type/format changed from ``/`` to `object`/`` for status `401`
  - the response's body type/format changed from ``/`` to `object`/`` for status `404`
  - the response's body type/format changed from ``/`` to `object`/`` for status `500`
  - the `conversationApiAppDetails/allOf[#/components/schemas/SmsConversationApiAppDto]/channelStatus` response's property type/format changed from `string`/`` to ``/`` for status `200`
  - …58 more
- **2026-08-18** `c78a716de420` — 1 info
  - api operation id `SmsAppsController_getSmsApp_v1` removed and replaced with `SmsSmsAppsController_getSmsApp_v1`

[Change history](https://skmtc.dev/sinch/apis/provisioning-api/changes/v1/projects/:projectId/sms/smsApps/:smsAppId/get.md)

---

[API](https://skmtc.dev/sinch/apis/provisioning-api.md) · [All operations](https://skmtc.dev/sinch/apis/provisioning-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sinch/provisioning-api/revisions/c6a937922d10/schema)