---
title: "List alphanumeric sender IDs"
method: GET
path: "/v1/sms/sender-ids"
tags: ["SMS"]
---

# List alphanumeric sender IDs

`GET /v1/sms/sender-ids`

## Response `200`

The workspace's sender IDs, newest first.

- object
  - `senderIds` object[]
    - `id` string
    - `senderId` string
    - `isActive` boolean
    - `createdAt` string, date-time, nullable
  - `budget` object — Workspace-wide daily sending budget, shared by every sender ID (resets midnight UTC).
    - `cap` integer — Daily message cap (raisable via `/v1/sms/sender-ids/limit-request`).
    - `usedToday` integer — Messages already counted against today's cap.
    - `level` integer — Cap tier (Level 1 = 500/day).
    - `pendingRequest` object, nullable — The in-flight cap-raise request awaiting review, or null. While set, further requests return 409.
      - `requestedCap` integer
      - `level` integer
      - `requestedAt` string, date-time, nullable

## Other responses

- `401` — Unauthorized

---

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