List carrier registrations
Authorization
bearerAuth API key authentication: send your Zernio API key in the Authorization header, prefixed with Bearer.
In: header
Query Parameters
Deactivated (terminated) registrations are hidden by default. Pass true to include them.
Response Body
application/json
application/json
application/json
import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.sms.listSmsRegistrations();console.log(data);{ "registrations": [ { "id": "string", "registrationType": "standard_10dlc", "displayName": "string", "status": "pending", "brandStatus": "string", "campaignStatus": "string", "brandId": "string", "campaignId": "string", "declineReason": "string", "tfActionRequiredAt": "2019-08-24T14:15:22Z", "phoneNumbers": [ "string" ], "awaitingOtp": true, "adminReviewNote": "string", "lastResponseAt": "2019-08-24T14:15:22Z", "previouslyRejected": true, "lastRejectedAt": "2019-08-24T14:15:22Z", "rejectedBeforeSubmission": true, "otpExpired": true, "reviewRequest": { "id": "string", "intro": "string", "points": [ { "id": "string", "title": "string", "detail": "string", "answer": "text" } ] }, "trustScore": 0, "throughput": { "label": "string", "smsPerMinute": 0, "smsPerDay": 0 } } ]}Add number to SMS registration
Attaches this number to your existing approved 10DLC campaign instead of running a fresh registration: the number inherits the campaign's approval (no new brand or campaign, no extra carrier fee). Enable SMS on the number first (`POST /v1/phone-numbers/{id}/sms`; its response tells you whether a reusable registration exists).
Pre-check a carrier registration
Dry-run of `POST /v1/sms/registrations` for 10DLC: validates and composes the exact brand/campaign payloads a submission would store (branding, disclosures, auto-replies), runs deterministic compliance lints plus an AI reviewer over them, and returns the findings WITHOUT creating anything. Use it to fix issues before submitting; `block` severity findings indicate a near-certain carrier rejection.