Brands
List your brands
Returns a paginated list of the 10DLC brands registered to your
organization, newest first. Use the X-Next-Cursor header from the
response to fetch the next page; the last page omits it.
A newly created brand starts with status of PENDING, and its
registry id and identity status are populated asynchronously once
carrier registration completes, so those fields may be null on a
brand you just created.
Requires the brands:read scope.
AuthorizationBearer <token>
Authenticate by sending your API key as a bearer token:
Authorization: Bearer am_live_.... Every request is automatically
scoped to the organization that owns the key and to the scopes granted
to that key.
In: header
Query Parameters
cursor?string
limit?integer
Default
20Range
1 <= value <= 100status?string
Value in
"PENDING" | "ACTIVE" | "DELETED"identity_status?string
Value in
"SELF_DECLARED" | "UNVERIFIED" | "VERIFIED" | "VETTED_VERIFIED"Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/brands"{
"success": true,
"data": [
{
"id": "6a1b2c3d-4e5f-6789-abcd-ef0123456789",
"org_id": "0190a1b2-c3d4-e5f6-a7b8-c9d0e1f2a3b4",
"tcr_brand_id": "BXKZQ9X",
"reference_id": "internal-brand-7421",
"status": "ACTIVE",
"identity_status": "VERIFIED",
"entity_type": "PRIVATE_PROFIT",
"brand_relationship": "SMALL_ACCOUNT",
"display_name": "Agentmessage Demo",
"company_name": "Agentmessage Inc",
"email": "ops@agentmessage.example",
"phone": "+15555550101",
"street": "1 Market St",
"city": "San Francisco",
"state": "CA",
"postal_code": "94105",
"country": "US",
"vertical": "TECHNOLOGY",
"website": "https://agentmessage.example",
"submitted_at": "2026-04-20T10:01:00Z",
"verified_at": "2026-04-21T16:32:11Z",
"created_at": "2026-04-20T10:00:00Z",
"updated_at": "2026-04-21T16:32:11Z"
}
],
"meta": {
"total": 0,
"limit": 20,
"offset": 0,
"next_cursor": null
}
}{
"success": false,
"error": {
"code": "UNAUTHORIZED",
"message": "authentication failed",
"request_id": "01JTBQH2FZ8K1RXC0WJ4Z9P3VM"
}
}{
"success": false,
"error": {
"code": "FORBIDDEN",
"message": "missing required scope",
"request_id": "01JTBQH2FZ8K1RXC0WJ4Z9P3VM"
}
}{
"success": false,
"error": {
"code": "VALIDATION_FAILED",
"message": "validation failed",
"request_id": "01JTBQH2FZ8K1RXC0WJ4Z9P3VM",
"details": {
"to": "must be E.164",
"body": "must be 1..1600 chars"
}
}
}