> ## 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.