Skip to content
DashboardGet API key

Sync 10DLC brand status

View .md
POST

Sync the brand status with the registration provider. Use this to check for approval updates after submission.

Authorization

  • Authorizationheaderrequired

    Bearer YOUR_API_KEY. Create a key in the dashboard.

Path parameters

  • brandIdstringrequired

    10DLC brand ID.

Responses

200Brand status synced.
  • brandobjectrequired
    27 properties
    • idstringrequired
    • entityTypestringrequired

      Business entity type for 10DLC brand registration.

      One ofPRIVATE_PROFITPUBLIC_PROFITNON_PROFITGOVERNMENTSOLE_PROPRIETOR
    • displayNamestringrequired

      Display name of the brand.

    • companyNamestringnullable

      Legal company name.

    • einstringnullable

      Tax id of the business: the Employer Identification Number (EIN) for a US brand, or the tax id from its own country's business register for a brand outside the US.

    • firstNamestringnullable
    • lastNamestringnullable
    • emailstring<email>required
    • phonestringrequired

      Contact phone number in E.164 format.

    • streetstringrequired
    • citystringrequired
    • statestringrequired
    • postalCodestringrequired
    • countrystringrequired

      Two-letter ISO country code.

    • websitestring<uri>nullable
    • verticalstringrequired

      Industry vertical.

    • stockSymbolstringnullable
    • stockExchangestringnullable
    • statusstringrequired

      Status of a 10DLC brand registration.

      • draft: created, not yet submitted to the carrier.
      • pending: submitted, awaiting the carrier's answer.
      • verified: the carrier registered the brand AND verified the business behind it.
      • unverified: the carrier registered the brand but did not verify the business — the registration exists, the identity check did not pass or has not been resolved. Campaigns are allowed, with lower daily limits. Read identityStatus for the carrier's own wording.
      • rejected: refused by the carrier.
      • failed: the registration never reached the carrier; the fee is refunded.
      One ofdraftpendingverifiedunverifiedrejectedfailed
    • identityStatusstringnullable

      The carrier's raw identity verdict on the business, as the carrier spells it (VERIFIED, VETTED_VERIFIED, SELF_DECLARED, UNVERIFIED). Null while the identity has not been resolved — which is not the same as verified, and is why such a brand reports status: unverified.

    • brandScoreintegernullable

      Trust score assigned by TCR after vetting.

    • brandRelationshipstringnullable
    • failureReasonstringnullable

      Reason for rejection, if applicable.

    • submittedAtstring<date-time>nullable
    • verifiedAtstring<date-time>nullable
    • createdAtstring<date-time>required
    • updatedAtstring<date-time>required
400Brand has not been submitted yet.
  • codestringrequired
  • messagestringrequired
  • detailsobject
401Unauthorized.
  • codestringrequired
  • messagestringrequired
  • detailsobject
404Brand not found.
  • codestringrequired
  • messagestringrequired
  • detailsobject