Skip to navigation
API Referenceregistration

Get Registration Status

Check the status of your A2P 10DLC registration.

Sub-account status

To check the registration status of a sub-account, pass the X-Sub-Account-Id header with the sub-account ID returned from POST /v1/register.

Possible statuses

  • none — No registration submitted.
  • pending — Registration is under review.
  • approved — Registration approved. Your account is ready to send messages.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Headers

X-Sub-Account-IdstringOptional

Check a sub-account's registration status. Pass the sub-account ID returned from POST /v1/register. Omit to check the master account.

Response

Successful Response
campaign_statusstring
messagestring
stagestring or nullOptional
issueobject or nullOptional

Set when stage is action_required: the reason and what to change. For a registration under review, resubmitting with PATCH /v1/register clears it. A registration that failed carrier review (campaign_status back to none) is resubmitted with POST /v1/register; a suspended one needs support.

sub_account_idstring or nullOptional

Set when the registration lives on a sub-account of the calling account (the default for POST /v1/register). Pass it as the X-Sub-Account-Id header to address that sub-account directly.