---
title: "List Sender IDs"
method: GET
path: "/v3/messages/sender-ids"
tags: ["SMS and MMS"]
---

# List Sender IDs

`GET /v3/messages/sender-ids`

Returns the Sender IDs registered for the authenticated account.

## Response `200`

Returns the list of Sender IDs.

- SenderIDListResponse
  - `items` SenderID[], required — List of Sender IDs.
    - `id` string, required — Sender ID ID.
    - `sender_id` string, required — Sender ID name.
    - `type` 'numeric' | 'alphanumeric', required — Format of the Sender ID. One of `numeric` (a phone number) or `alphanumeric` (a text sender name).
    - `allowlisted_in` string[], required — Two-letter ISO country codes where the Sender ID is allowlisted.
    - `usecase` string — Primary use case declared for the Sender ID, such as `transactional`, `promo`, or `authentication`.
    - `samples` string[] — Message samples.

## Other responses

- `403` — Request failed. The feature is disabled for your account.

---

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