Skip to content

List 10DLC brands

View .md
GET

List 10DLC brand registrations for this project.

Authorization

  • Authorizationheaderrequired

    Bearer YOUR_API_KEY. Create a key in the dashboard.

Query parameters

  • limitinteger
    Default50
    Limitsmax 100
  • cursorstring

Responses

200List of brands.
  • itemsobject[]required
    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
  • nextCursorstringnullable
401Unauthorized.
  • codestringrequired
  • messagestringrequired
  • detailsobject