Retrieve a Brand
GET/registry/beta/brands/:id
Retrieves the details of a Brand that has been previously created. Use the unique ID that was returned from your previous request to identify the specific Brand.
Permissions
The API token must include the following scopes: Messaging.
Request
Path Parameters
Unique ID of the brand
Responses
- 200
OK
- application/json
- Schema
- Example (from schema)
Schema
The unique id of the brand.
The current state of the brand.
Brand/Marketing/DBA name of the business if applicable..
The legal name of the business.
A company contact email for this brand.
A contact phone number for this brand.
Country of registration.
What type of legal entity is the organization? (PRIVATE_PROFIT
, PUBLIC_PROFIT
, NON_PROFIT
)
Company EIN Number/Tax ID
Full company address.
An optional Vertical for the brand (REAL_ESTATE
, HEALTHCARE
, ENERGY
, ENTERTAINMENT
, RETAIL
, AGRICULTURE
, INSURANCE
, EDUCATION
, HOSPITALITY
, FINANCIAL
, GAMBLING
, CONSTRUCTION
, NGO
, MANUFACTURING
, GOVERNMENT
, TECHNOLOGY
, COMMUNICATION
).
Link to the company website.
If you are your own Campaign Service Provider, this is the approved Brand ID (Mandatory for CSPs, otherwise please omit)
This value must be true for all self-registered brands.
Optional: Specify a URL to receive webhook notifications when your brand’s state changes.
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"state": "pending",
"name": "My Brand",
"company_name": "BrandCo",
"contact_email": "brand_info@example.com",
"contact_phone": "+18995551212",
"ein_issuing_country": "United States",
"legal_entity_type": "Private Company",
"ein": "12-3456789",
"company_address": "123 Brand St, Hill Valley CA, 91905",
"company_vertical": "Healthcare",
"company_website": "www.example.com",
"csp_brand_reference": null,
"csp_self_registered": false,
"status_callback_url": "https//example.com/handle_callback",
"created_at": "2024-07-29T15:51:28.071Z",
"updated_at": "2024-07-29T15:51:28.071Z"
}