---
title: "List all sms apps"
method: GET
path: "/v1/projects/{projectId}/sms/smsApps"
tags: ["SMS Apps"]
---

# List all sms apps

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

Returns a paginated list of all sms apps. If no page token is supplied then the first `50` will be returned.

## Path parameters

- `projectId` string, required

## Query parameters

- `pageSize` number
- `pageToken` string

## Response `200`

List of sms apps

- SmsSmsAppListDto
  - `totalSize` number, required — Total size of the entries matching the search query.
  - `pageSize` number, required — Requested size of the page.
  - `previousPageToken` string — Encoded token to use in list request to fetch previous batch of entries.
  - `nextPageToken` string — Encoded token to use in list request to fetch next batch of entries.
  - `smsApps` SmsSmsAppDto[], required — List of sms apps.
    - `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` string[], 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

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

---

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