---
title: "List sender registrations"
method: GET
path: "/v2/senders/registrations"
tags: ["Senders"]
---

# List sender registrations

`GET /v2/senders/registrations`

Returns a paginated list of sender registrations for the authenticated account.

  - If the account does not use parent/child accounts, the API returns registrations for the authenticated account.
  - If the account is a parent account, the API returns registrations for the parent account and all child accounts.

## Query parameters

- `page` integer
- `limit` integer
- `child_account_id` string
- `sender` string
- `status` string

## Response `200`

Successful response containing a paginated list of sender registrations.

- object
  - `data` object, required — Paginated list of sender registrations.
    - `registrations` SenderRegistration[], required — Array of sender registrations.
      - `registration_id` string, uuid, required — Unique identifier for the registration.
      - `sender` string, required — The registered sender number.
      - `country` string, required — ISO 3166-1 alpha-2 country code for the sender.
      - `type` 'PERSONAL_MOBILE_NUMBER' | 'ALPHANUMERIC', required — Type of a sender registration record (as returned by the API). - `PERSONAL_MOBILE_NUMBER` — a personal mobile number registered as a sender. - `ALPHANUMERIC` — an alphanumeric (alpha) sender ID. Type-specific fields are returned under `details.alphanumeric`. Alpha registrations are created through the registration backoffice, not this public API.
      - `status` 'PENDING_APPROVAL' | 'VERIFIED' | 'REJECTED' | 'CANCELLED', required — Status of a sender registration. The same coarse set of statuses applies to every registration `type`: - `PERSONAL_MOBILE_NUMBER` — `PENDING_APPROVAL`, `VERIFIED`, `REJECTED`, `CANCELLED`. - `ALPHANUMERIC` — `PENDING_APPROVAL`, `VERIFIED`, `REJECTED`. The finer alpha registry lifecycle is surfaced separately and is not part of this coarse enum.
      - `created_at` string, date-time, required — Timestamp in RFC3339 format (e.g., 2025-08-26T10:30:00Z) when the registration was created.
      - `child_account_id` string — Child account ID the sender is registered for. Only present for registrations created under a child account.
      - `updated_at` string, date-time, required — Timestamp in RFC3339 format (e.g., 2025-08-26T10:32:00Z) when the registration was last updated.
      - `details` SenderRegistrationDetails — Type-specific details for a sender registration. The populated sub-object matches the registration `type` — for an `ALPHANUMERIC` registration, `alphanumeric` is present.
        - `alphanumeric` AlphanumericDetails — Details specific to an alphanumeric (alpha) sender registration.
          - `registry` 'ACMA', required — The registry body an alphanumeric sender registration is submitted to. - `ACMA` — Australian Communications and Media Authority.
          - `status` 'NEW' | 'SUBMITTED_TO_REGISTRY' | 'PENDING_CUSTOMER' | 'PENDING_APPROVAL' | 'VERIFIED' | 'READY_TO_USE' | 'FAILED' | 'REVOKED' | 'CANCELLED' — Fine-grained registry lifecycle status for an alphanumeric registration — the state the customer sees on screen, distinct from the coarse root `status`. This enum is **expected to grow** as a registry (e.g. ACMA) introduces new states. The server only ever returns a value it has explicitly mapped, and new values are added here additively — so **clients must render a graceful fallback for any value they don't yet recognise** rather than treating the set as fixed. Value → display label: - `NEW` — Initial Review - `SUBMITTED_TO_REGISTRY` — Submitted - `PENDING_CUSTOMER` — Awaiting Confirmation - `PENDING_APPROVAL` — In ACMA Review - `VERIFIED` — Provisioning - `READY_TO_USE` — Ready to Use - `FAILED` — Failed - `REVOKED` — Revoked - `CANCELLED` — Cancelled
          - `status_reason` string — Optional human-readable reason for the current `status` (verbatim registry status description), suitable for tooltips. May be absent or blank.
  - `request` object — Optional metadata (e.g. requestId, traceId)
  - `meta` object, required — Optional pagination, feature flags, etc.
    - `pagination` PagePaginationMeta, required — Pagination metadata for page-based pagination. Reusable across all paginated API endpoints that use page/limit pagination.
      - `type` 'page', required — The pagination strategy being used.
      - `page` integer, required — The current page number (1-based).
      - `limit` integer, required — The maximum number of results per page.
      - `total_count` integer, required — The total number of results across all pages.

## Other responses

- `400` — Input Validation Error
- `401` — Unauthorized
- `500` — Internal Server Error

---

[API](https://skmtc.net/kudosity/apis/transmit-sms-api.md) · [All operations](https://skmtc.net/kudosity/apis/transmit-sms-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kudosity/transmit-sms-api/versions/9f6c34b849af/schema)