> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lumisreach.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.

<Info>
  The Branded Calling API is **coming soon**. These endpoints are under active development and will be available in an upcoming release.
</Info>

## What's coming

The Branded Calling API will let you programmatically manage your Display Identity Record (DIR), which controls how your business appears on recipients' screens when you place outbound calls.

### Planned endpoints

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

To learn more about how Branded Calling works, see the [Caller Trust](/concepts/caller-trust) guide.