Get the 10DLC brand registration for the authenticated account. Returns null when no registration exists yet.

GET

/registrations/us/10dlc/brand

curl --request GET \
  --url https://api.pingram.io/registrations/us/10dlc/brand \
  --header 'Authorization: Bearer <token>'

• Production

Authorizations

• apiKey
• clientCredentials
• endUser
• endUserHashed

Responses

200

Successful response

Media typeapplication/json

Public response type for 10DLC brand registration

object

accountId

required

string

scenarioId

required

string

businessType

required

string

legalName

required

string

displayName

Brand display name (marketing/DBA); defaults to legalName on customer submit.

string

firstName

string

lastName

string

taxId

string

website

required

string

country

required

string

street

string

city

string

state

string

postalCode

string

fullAddress

Legacy records only; new submissions use structured address fields.

string

complianceContactEmail

required

string

complianceContactPhone

required

string

brandStatus

required

Pingram-side 10DLC registration workflow status (brand or campaign).

• not_started: no customer submission yet
• pending_review: customer submitted; Pingram has not submitted to carriers
• in_progress: submitted for carrier review
• approved | rejected | info_needed: review outcome

string

Allowed values: not_started in_progress pending_review approved rejected info_needed

campaignStatus

required

Pingram-side 10DLC registration workflow status (brand or campaign).

• not_started: no customer submission yet
• pending_review: customer submitted; Pingram has not submitted to carriers
• in_progress: submitted for carrier review
• approved | rejected | info_needed: review outcome

string

Allowed values: not_started in_progress pending_review approved rejected info_needed

createdAt

required

string

updatedAt

required

string

Example

{
  "brandStatus": "not_started",
  "campaignStatus": "not_started"
}

400

Bad Request - validation errors, invalid input

Media typeapplication/json

Standard error response for API errors.

object

trackingId

required

Unique tracking ID for the request.

string

error

required

Structured error details for API error responses.

object

code

required

Machine-readable error code.

string

message

required

Human-readable error message.

string

fix

Actionable hint for fixing the error.

string

Example^generated

{
  "trackingId": "example",
  "error": {
    "code": "example",
    "message": "example",
    "fix": "example"
  }
}

401

Unauthorized

402

Payment Required - usage limits exceeded

Media typeapplication/json

Standard error response for API errors.

object

trackingId

required

Unique tracking ID for the request.

string

error

required

Structured error details for API error responses.

object

code

required

Machine-readable error code.

string

message

required

Human-readable error message.

string

fix

Actionable hint for fixing the error.

string

Example^generated

{
  "trackingId": "example",
  "error": {
    "code": "example",
    "message": "example",
    "fix": "example"
  }
}

500

Internal Server Error

502

Bad Gateway - provider error

Media typeapplication/json

Standard error response for API errors.

object

trackingId

required

Unique tracking ID for the request.

string

error

required

Structured error details for API error responses.

object

code

required

Machine-readable error code.

string

message

required

Human-readable error message.

string

fix

Actionable hint for fixing the error.

string

Example^generated

{
  "trackingId": "example",
  "error": {
    "code": "example",
    "message": "example",
    "fix": "example"
  }
}