---
title: "Retrieve a Sender ID"
method: GET
path: "/v3/messages/sender-ids/{id}"
tags: ["SMS and MMS"]
---

# Retrieve a Sender ID

`GET /v3/messages/sender-ids/{id}`

## Request

- Base URL: `https://api.wavix.com`
- URL: `https://api.wavix.com/v3/messages/sender-ids/{id}`
- Auth: HTTP bearer

Returns the Sender ID identified by `id`.

## Path parameters

- `id` string, uuid, required

## Response `200`

Returns the Sender ID.

- SenderIDResponse
  - `id` string, uuid, required: Sender ID ID.
  - `sender_id` string, required: Sender ID.
  - `type` 'alphanumeric' | 'numeric' | 'shortcode', required: Format of the Sender ID. One of `alphanumeric` (a text sender name), `numeric` (a phone number), or `shortcode` (a short code).
  - `usecase` string: Use case for the Sender ID.
  - `samples` string[]: Message samples.
  - `allowlisted_in` string[]: List of countries where the Sender ID is allowlisted.

## Other responses

- `400`: Request failed. Missing or invalid parameter <param_name>
- `401`: Unauthorized
- `403`: Request failed. The feature is disabled for your account.
- `404`: Request failed. An object with the specified ID is not found.

## Changes

- **2026-09-08** `6a89c962481c`: 1 breaking, 9 info
  - the response's body type changed from no type to `object` for status `200`
  - removed `#/components/schemas/SenderIDResponse` from the response body `allOf` list for the response status `200`
  - added the non-success response with the status `400`
  - added the non-success response with the status `401`
  - …6 more
- **2026-06-15** `76b9bb35619f`: 2 info
  - added `#/components/schemas/SenderIDResponse` to the response body `allOf` list for the response status `200`
  - removed `#/components/schemas/SenderIdResponse` from the response body `allOf` list for the response status `200`
- **2026-05-25** `33be77905120`: 1 info
  - the endpoint scheme security `bearerAuth` was added to the API
- **2026-04-20** `2e48fd9894e1`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/wavix/apis/wavix-apis/changes/v3/messages/sender-ids/:id/get.md)

---

[API](https://skmtc.dev/wavix/apis/wavix-apis.md) - [All operations](https://skmtc.dev/wavix/apis/wavix-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/wavix/apis/wavix-apis/revisions/f2dde79f05ab?raw)