---
title: "List carrier registrations"
method: GET
path: "/v1/sms/registrations"
tags: ["SMS"]
---

# List carrier registrations

`GET /v1/sms/registrations`

## Query parameters

- `includeDeactivated` boolean

## Response `200`

Registrations, newest first

- object
  - `registrations` object[]
    - `id` string
    - `registrationType` 'standard_10dlc' | 'sole_prop_10dlc' | 'toll_free'
    - `displayName` string, nullable
    - `status` 'pending' | 'approved' | 'rejected' | 'requested' | 'changes_requested' | 'deactivated' — requested/changes_requested = pre-submission review states; customers see them as pending / needs changes.
    - `brandStatus` string — Carrier-registry brand status (e.g. VERIFIED).
    - `campaignStatus` string
    - `brandId` string, nullable — TCR brand id, useful when referencing the brand in carrier support threads.
    - `campaignId` string, nullable — TCR campaign id.
    - `declineReason` string, nullable
    - `tfActionRequiredAt` string, date-time, nullable — Toll-free only: when the carrier requested changes ("Waiting For Customer"). The request must be resubmitted within 7 days of this timestamp or it expires.
    - `phoneNumbers` string[]
    - `awaitingOtp` boolean — Sole-prop 10DLC only; the OTP step is still pending.
    - `trustScore` number, nullable — Carrier-assigned brand trust score; drives throughput.
    - `throughput` object — Carrier throughput tier derived from the trust score.
      - `label` string
      - `smsPerMinute` number
      - `smsPerDay` number

## Other responses

- `400` — Invalid request
- `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/versions/51932b099b2f/schema)