List carrier registrations

GET/api/v1/sms/registrations

GET /sms/registrations

curl -X GET 'https://www.unitpost.com/api/v1/sms/registrations' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'User-Agent: my-app/1.0'

Response · 200

{
  "object": "list",
  "has_more": false,
  "data": [
    {
      "object": "sms_registration",
      "id": "id_123",
      "type": "string",
      "brand_id": "brand_123",
      "status": "queued",
      "requires_action": false,
      "feedback": [
        {}
      ],
      "use_case": "string",
      "message_type": "string",
      "parent_registration_id": "parent_registration_123",
      "auto_provision_number": false,
      "sender": {
        "id": "id_123",
        "status": "queued",
        "phone_number": "string"
      },
      "setup_state": "string",
      "number_withheld_reason": "string",
      "archived_at": "2026-01-01T00:00:00.000Z",
      "submitted_at": "2026-01-01T00:00:00.000Z",
      "completed_at": "2026-01-01T00:00:00.000Z",
      "created_at": "2026-01-01T00:00:00.000Z"
    }
  ]
}

Your carrier registrations (10DLC brand and campaign, toll-free) with their review state and the carrier's feedback; a 10DLC campaign also carries the number it backs and one setup state. Submitting or resubmitting a 10DLC one is an SMS quote, then its confirm; toll-free verification and removing one happen in the dashboard. Requires the sms:read capability.

Parameters3 fields

Field	Type	Description
`limit`	integer · query	Max rows to return (default 20, max 100).
`after`	string · query	Return rows after this id (forward paging).
`before`	string · query	Return rows before this id (backward paging).

Response · 200 fields18 fields

Field	Type	Description
`object`required	string	—
`id`required	string	—
`type`required	string	`us_ten_dlc_brand`, `us_ten_dlc_campaign`, or a toll-free verification.
`brand_id`required	string \| null	—
`status`required	string	The carrier review state: `draft`, `submitted`, `reviewing`, `requires_updates`, `complete`, `closed`, …
`requires_action`required	boolean	The customer must act (the carrier asked for changes).
`feedback`required	object[] \| null	The carrier's reasons when it asks for changes or closes it (`reason`, `description`, `field_path`, `link`).
`use_case`required	string \| null	—
`message_type`required	string \| null	—
`parent_registration_id`required	string \| null	—
`auto_provision_number`required	boolean \| null	10DLC campaigns: a number is leased when carriers approve.
`sender`required	object \| null	10DLC campaigns: the number it backs, once one exists.
`setup_state`required	string \| null	10DLC campaigns: one customer-facing state over the campaign and its number.
`number_withheld_reason`required	string \| null	Why an approved campaign's number isn't being leased (e.g. the plan has no carrier resources).
`archived_at`required	string \| null	—
`submitted_at`required	string \| null	—
`completed_at`required	string \| null	—
`created_at`required	string	—

200401403404422

List carrier registrations

List carrier registrations

Search docs and guides