> ## Documentation Index
> Fetch the complete documentation index at: https://docs.revdesk.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Branded Calling

> Manage your Display Identity Record (DIR) to show your business name, logo, and call reason on recipients' screens.

Branded Calling lets you manage your **Display Identity Record (DIR)** — the business name, logo, and
call reason shown on a recipient's screen when you call. The API is **available in beta**: the
endpoints below are live, and your branded identity appears on more devices as networks approve it.

<Note>
  Branded Calling requires a **vetted enterprise registration** first — your brand is attested to your
  legal entity. Complete [Enterprise Registration](/api-reference/enterprise-registration) before
  submitting a DIR.
</Note>

## Endpoints

| Method | Path | Description |
| - | - | - |
| `GET` | `/v1/caller-trust/brand` | Retrieve your current DIR and approval status |
| `PUT` | `/v1/caller-trust/brand` | Create or update your DIR draft (display name, logo, call reason) |
| `POST` | `/v1/caller-trust/brand/submit` | Submit your completed DIR for review |

## DIR fields

| Field | Requirements |
| - | - |
| Display name | Your legal business name, up to 64 characters |
| Call reason | Brief description of why you're calling, up to 120 characters |
| Logo | Square image (PNG, JPEG, or WebP), minimum 200 x 200 px |

## How it works

1. **Draft** your DIR with `PUT /v1/caller-trust/brand` (display name, call reason, logo).
2. **Submit** it for review with `POST /v1/caller-trust/brand/submit`.
3. **Track approval** with `GET /v1/caller-trust/brand` — the status moves from draft to submitted to
   approved as review completes. Display on recipients' screens rolls out per network once approved.

To learn how Branded Calling relates to caller-ID reputation and CNAM, see the
[Caller Trust](/concepts/caller-trust) guide.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.