Retrieve an SMS brand

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

GET /sms/brands/{id}

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

Response · 200

{
  "object": "sms_brand",
  "id": "id_123",
  "name": "Example",
  "legal_name": "string",
  "website": "string",
  "domain": "string",
  "contact_email": "string",
  "status": "incomplete",
  "missing": [
    "string"
  ],
  "ten_dlc_verified": false,
  "tax_id_on_file": false,
  "number_count": 1,
  "editable": false,
  "dba_name": "string",
  "sender_id_name": "string",
  "vertical": "string",
  "legal_organization_type": "string",
  "registration_number_type": "string",
  "tax_country": "string",
  "stock_symbol": "string",
  "stock_exchange": "string",
  "contact": {
    "first_name": "string",
    "last_name": "string",
    "phone": "string"
  },
  "address": {
    "address1": "string",
    "address2": "string",
    "city": "string",
    "state": "string",
    "zip_code": "string",
    "iso_country_code": "string"
  },
  "revision": 0,
  "archived_at": "2026-01-01T00:00:00.000Z",
  "created_at": "2026-01-01T00:00:00.000Z"
}

One brand with every field you can edit, its status and missing list. Requires the sms:read capability.

Parameters1 field

Field	Type	Description
`id`required	string · path	—

Response · 200 fields26 fields

Field	Type	Description
`object`required	string	—
`id`required	string	Prefixed brand id, e.g. `sbrand_…`.
`name`required	string	Public-facing brand name.
`legal_name`required	string	Registered legal entity name.
`website`required	string \| null	Brand website URL.
`domain`required	string \| null	Registrable domain derived from the website. The brand contact email must be on this domain.
`contact_email`required	string \| null	—
`status`required	enumincomplete \| ready \| pending \| action_required \| verified \| rejected \| archived	`incomplete` and `action_required` need the customer to act in the dashboard; `pending` is waiting on the carrier.
`missing`required	string[]	Human-readable list of what is still required before this brand can back a number. Empty when nothing is missing.
`ten_dlc_verified`required	boolean	True when the 10DLC brand registration is approved.
`tax_id_on_file`required	boolean	—
`number_count`required	integer	Non-released senders on this brand (phone numbers and Sender ID countries, any status).
`editable`required	boolean	False once the brand is locked: carriers approved or are reviewing its 10DLC registration, or senders are registered with its details. Locked brands are corrected only when carriers ask.
`dba_name`	string \| null	The name the business trades under, when it isn't the legal name.
`sender_id_name`	string \| null	The one Sender ID the brand sends under abroad (1–11 characters).
`vertical`	string \| null	The brand's industry, in the carriers' words (e.g. `RETAIL`).
`legal_organization_type`	string \| null	`PRIVATE_PROFIT`, `PUBLIC_PROFIT`, `NON_PROFIT`, `GOVERNMENT`, …
`registration_number_type`	string \| null	—
`tax_country`	string \| null	—
`stock_symbol`	string \| null	—
`stock_exchange`	string \| null	—
`contact`	object	Who carriers reach about the brand (the email is `contact_email`).
`address`	object	The registered business address.
`revision`	integer	Moves on every material change; a registration keeps the revision it was submitted with.
`archived_at`	string \| null	—
`created_at`required	string	—

200401403404422

Retrieve an SMS brand

Retrieve an SMS brand

Search docs and guides