List brand registrations

GET /v1/a2p/BrandRegistrations

A Messaging Service resource to add and fetch Brand Registrations.

Query parameters

  • PageSize integer(int64)

    How many resources to return in each list page. The default is 50, and the maximum is 1000.

    Minimum value is 1, maximum value is 1000.

  • Page integer

    The page index. This value is simply for client state.

    Minimum value is 0.

  • PageToken string

    The page token. This is provided by the API.

Responses

  • 200 application/json

    OK

    Hide headers attributes Show headers attributes
    • Access-Control-Allow-Origin string

      Specify the origin(s) allowed to access the resource

    • Access-Control-Allow-Methods string

      Specify the HTTP methods allowed when accessing the resource

    • Access-Control-Allow-Headers string

      Specify the headers allowed when accessing the resource

    • Access-Control-Allow-Credentials boolean

      Indicates whether the browser should include credentials

    • Access-Control-Expose-Headers string

      Headers exposed to the client

    Hide response attributes Show response attributes object
    • data array[object]
      Hide data attributes Show data attributes object
      • sid string | null

        The unique string to identify Brand Registration.

        Minimum length is 34, maximum length is 34. Format should match the following pattern: ^BN[0-9a-fA-F]{32}$.

      • account_sid string | null

        The SID of the Account that created the Brand Registration resource.

        Minimum length is 34, maximum length is 34. Format should match the following pattern: ^AC[0-9a-fA-F]{32}$.

      • customer_profile_bundle_sid string | null

        A2P Messaging Profile Bundle BundleSid.

        Minimum length is 34, maximum length is 34. Format should match the following pattern: ^BU[0-9a-fA-F]{32}$.

      • a2p_profile_bundle_sid string | null

        A2P Messaging Profile Bundle BundleSid.

        Minimum length is 34, maximum length is 34. Format should match the following pattern: ^BU[0-9a-fA-F]{32}$.

      • date_created string(date-time) | null

        The date and time in GMT when the resource was created specified in ISO 8601 format.

      • date_updated string(date-time) | null

        The date and time in GMT when the resource was last updated specified in ISO 8601 format.

      • brand_type string | null

        Type of brand. One of: "STANDARD", "SOLE_PROPRIETOR". SOLE_PROPRIETOR is for the low volume, SOLE_PROPRIETOR campaign use case. There can only be one SOLE_PROPRIETOR campaign created per SOLE_PROPRIETOR brand. STANDARD is for all other campaign use cases. Multiple campaign use cases can be created per STANDARD brand.

      • status string

        Brand Registration status. One of "PENDING", "APPROVED", "FAILED", "IN_REVIEW", "DELETION_PENDING", "DELETION_FAILED", "SUSPENDED".

        Values are PENDING, APPROVED, FAILED, IN_REVIEW, DELETION_PENDING, DELETION_FAILED, or SUSPENDED.

      • tcr_id string | null

        Campaign Registry (TCR) Brand ID. Assigned only after successful brand registration.

      • failure_reason string | null

        DEPRECATED. A reason why brand registration has failed. Only applicable when status is FAILED.

      • errors array[object] | null

        A list of errors that occurred during the brand registration process.

      • url string(uri) | null

        The absolute URL of the Brand Registration resource.

      • brand_score integer | null

        The secondary vetting score if it was done. Otherwise, it will be the brand score if it's returned from TCR. It may be null if no score is available.

      • brand_feedback array[string] | null

        DEPRECATED. Feedback on how to improve brand score

        Values are TAX_ID, STOCK_SYMBOL, NONPROFIT, GOVERNMENT_ENTITY, or OTHERS.

      • identity_status string

        When a brand is registered, TCR will attempt to verify the identity of the brand based on the supplied information.

        Values are SELF_DECLARED, UNVERIFIED, VERIFIED, or VETTED_VERIFIED.

      • russell_3000 boolean | null

        Publicly traded company identified in the Russell 3000 Index

      • government_entity boolean | null

        Identified as a government entity

      • tax_exempt_status string | null

        Nonprofit organization tax-exempt status per section 501 of the U.S. tax code.

      • skip_automatic_sec_vet boolean | null

        A flag to disable automatic secondary vetting for brands which it would otherwise be done.

      • mock boolean | null

        A boolean that specifies whether brand should be a mock or not. If true, brand will be registered as a mock brand. Defaults to false if no value is provided.

    • meta object
      Hide meta attributes Show meta attributes object
      • first_page_url string(uri)
      • key string
      • next_page_url string(uri) | null
      • page integer
      • page_size integer
      • previous_page_url string(uri) | null
      • url string(uri)
GET /v1/a2p/BrandRegistrations
curl \
 --request GET 'https://messaging.twilio.com/v1/a2p/BrandRegistrations' \
 --user "username:password"
Response examples (200)
{
  "data": [
    {
      "sid": "BN0044409f7e067e279523808d267e2d85",
      "url": "https://messaging.twilio.com/v1/a2p/BrandRegistrations/BN0044409f7e067e279523808d267e2d85",
      "mock": false,
      "links": {
        "brand_vettings": "https://messaging.twilio.com/v1/a2p/BrandRegistrations/BN0044409f7e067e279523808d267e2d85/Vettings",
        "brand_registration_otps": "https://messaging.twilio.com/v1/a2p/BrandRegistrations/BN0044409f7e067e279523808d267e2d85/SmsOtp"
      },
      "errors": [],
      "status": "APPROVED",
      "tcr_id": "BXXXXXX",
      "brand_type": "STANDARD",
      "account_sid": "AC78e8e67fc0246521490fb9907fd0c165",
      "brand_score": 42,
      "date_created": "2021-01-27T14:18:35Z",
      "date_updated": "2021-01-27T14:18:36Z",
      "russell_3000": true,
      "brand_feedback": [
        "TAX_ID",
        "NONPROFIT"
      ],
      "failure_reason": "Registration error",
      "identity_status": "VERIFIED",
      "government_entity": false,
      "tax_exempt_status": "501c3",
      "a2p_profile_bundle_sid": "BU3344409f7e067e279523808d267e2d85",
      "skip_automatic_sec_vet": false,
      "customer_profile_bundle_sid": "BU3344409f7e067e279523808d267e2d85"
    }
  ],
  "meta": {
    "key": "data",
    "url": "https://messaging.twilio.com/v1/a2p/BrandRegistrations?PageSize=50&Page=0",
    "page": 0,
    "page_size": 50,
    "next_page_url": null,
    "first_page_url": "https://messaging.twilio.com/v1/a2p/BrandRegistrations?PageSize=50&Page=0",
    "previous_page_url": null
  }
}
{
  "data": [
    {
      "sid": "BN0044409f7e067e279523808d267e2d85",
      "url": "https://messaging.twilio.com/v1/a2p/BrandRegistrations/BN0044409f7e067e279523808d267e2d85",
      "mock": false,
      "links": {
        "brand_vettings": "https://messaging.twilio.com/v1/a2p/BrandRegistrations/BN0044409f7e067e279523808d267e2d85/Vettings",
        "brand_registration_otps": "https://messaging.twilio.com/v1/a2p/BrandRegistrations/BN0044409f7e067e279523808d267e2d85/SmsOtp"
      },
      "errors": [
        {
          "url": "https://www.twilio.com/docs/api/errors/30701",
          "fields": [
            "region"
          ],
          "error_code": 30701,
          "description": "Invalid State/Region/Province. please check the input field value [Max length 20, For The United States, please use 2 character codes. E.g. 'CA' for California] and retry."
        }
      ],
      "status": "APPROVED",
      "tcr_id": "BXXXXXX",
      "brand_type": "STANDARD",
      "account_sid": "AC78e8e67fc0246521490fb9907fd0c165",
      "brand_score": 42,
      "date_created": "2021-01-27T14:18:35Z",
      "date_updated": "2021-01-27T14:18:36Z",
      "russell_3000": true,
      "brand_feedback": [
        "TAX_ID",
        "NONPROFIT"
      ],
      "failure_reason": "Registration error",
      "identity_status": "VERIFIED",
      "government_entity": false,
      "tax_exempt_status": "501c3",
      "a2p_profile_bundle_sid": "BU3344409f7e067e279523808d267e2d85",
      "skip_automatic_sec_vet": false,
      "customer_profile_bundle_sid": "BU3344409f7e067e279523808d267e2d85"
    }
  ],
  "meta": {
    "key": "data",
    "url": "https://messaging.twilio.com/v1/a2p/BrandRegistrations?PageSize=50&Page=0",
    "page": 0,
    "page_size": 50,
    "next_page_url": null,
    "first_page_url": "https://messaging.twilio.com/v1/a2p/BrandRegistrations?PageSize=50&Page=0",
    "previous_page_url": null
  }
}