Skip to content
DashboardGet API key

Submit 10DLC brand for review

View .md
POST

Submit a draft brand to The Campaign Registry (TCR) for vetting. The brand must be in draft status, and the team must have an approved Business Verification (KYB) — carriers register a brand against a vetted legal entity, so submitting without one returns 403 with code kyb_required.

TCR's one-time $4 brand registration fee is charged from your balance at submission (passed through at cost) and refunded if the carrier rejects the registration. The fee is per BRAND: a team registering a second legal entity pays it again. A brand already paid for through the compliance flow is not charged twice. Campaign registration is billed separately when a campaign is submitted.

Authorization

  • Authorizationheaderrequired

    Bearer YOUR_API_KEY. Create a key in the dashboard.

Path parameters

  • brandIdstringrequired

    10DLC brand ID.

Responses

200Brand submitted for review.
  • 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 already submitted or invalid status, or it lacks an EIN, which every entity type except `SOLE_PROPRIETOR` needs to register (`invalid_request`, nothing charged). Or the carrier refused the registration (`invalid_request`, with the carrier's reason in `message`). On a refusal the fee is refunded and the brand stays `draft`, so it can be corrected and submitted again.
  • codestringrequired
  • messagestringrequired
  • detailsobject
401Unauthorized.
  • codestringrequired
  • messagestringrequired
  • detailsobject
402The balance cannot cover the one-time registration fee, so nothing was charged and nothing reached the carrier. Add funds and submit again.
  • codestringrequired
  • messagestringrequired
  • detailsobject
403Business verification (KYB) is not approved. Carriers register 10DLC against a vetted legal entity, so registration is blocked until it is.
  • codestringrequired
  • messagestringrequired
  • detailsobject
404Brand not found.
  • codestringrequired
  • messagestringrequired
  • detailsobject