Retrieve a carrier registration

GET/api/v1/sms/registrations/{id}

GET /sms/registrations/{id}

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

Response · 200

{
  "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"
}

One carrier registration (sreg_…), read as List carrier registrations reads it. Read a resubmit, a removal or a replacement back with it. Requires the sms:read capability.

Parameters1 field

Field	Type	Description
`id`required	string · path	—

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

Retrieve a carrier registration

Retrieve a carrier registration

Search docs and guides