Skip to content

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>'

Authorizations

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

Official registered legal business name. For SOLE_PROPRIETOR, may be a DBA or trade name.

string
displayName

Public brand name shown to recipients and carriers.

string
firstName

Legal first name of the sole proprietor. Present when businessType is SOLE_PROPRIETOR.

string
lastName

Legal last name of the sole proprietor. Present when businessType is SOLE_PROPRIETOR.

string
taxId

For US companies (country US): 9-digit EIN (Employer Identification Number). For Canada (country CA): 9-digit BN (Business Number). For other countries: national business tax identifier. Omitted when businessType is SOLE_PROPRIETOR.

string
website
required

Public website for the brand.

string
country
required

ISO 3166-1 alpha-2 country of incorporation (for example US or CA).

string
street

Street address that matches official tax registration.

string
city

City that matches official tax registration.

string
state

State (US) or province (CA) that matches official tax registration.

string
postalCode

ZIP code (US) or postal code (CA) that matches official tax registration.

string
fullAddress

Legacy records only; new submissions use structured address fields.

string
complianceContactEmail
required

Email for the 10DLC compliance contact.

string
complianceContactPhone
required

Phone number for the 10DLC compliance contact.

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
Examplegenerated
{
  "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
Examplegenerated
{
  "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
Examplegenerated
{
  "trackingId": "example",
  "error": {
    "code": "example",
    "message": "example",
    "fix": "example"
  }
}