---
title: "Render the Branded Calling LOA for a DIR"
method: POST
path: "/dir/{dir_id}/loa"
tags: ["Display Identity Records"]
---

# Render the Branded Calling LOA for a DIR

`POST /dir/{dir_id}/loa`

Generate a pre-filled Letter of Authorization (LOA) PDF for a DIR. Enterprise identity (legal name, DBA, address, contact, website, tax id) and the DIR display name are read server-side; the caller supplies the telephone numbers to authorize, an optional Authorized Agent block, and an optional drawn signature.

When `signature` is omitted the PDF is returned unsigned so the customer can sign it externally and upload it via the Documents API. When `signature` is present the PDF embeds the supplied image, printed name, and signed-at date.

Returns `application/pdf`.

## Path parameters

- `dir_id` string, uuid, required

## Request body

- BrandLoaRenderRequest
  - `phone_numbers` string[], required — Telephone numbers to authorize on the DIR, in `+E164` format (`+` followed by 10-15 digits). Max 15 per request.
  - `agent` AgentInput — Third-party reseller / partner managing the enterprise's phone numbers. Omit when the enterprise works directly with Telnyx.
    - `legal_name` string, required
    - `dba` string, nullable
    - `street_address` string, required
    - `extended_address` string, nullable
    - `city` string, required
    - `administrative_area` string, required
    - `postal_code` string, required
    - `country` string, required
    - `contact_name` string, required
    - `contact_title` string, required
    - `contact_email` string, email, required
    - `contact_phone` string, required
  - `signature` SignaturePayload
    - `image_base64` string, required — PNG image, base64-encoded.
    - `signer_name` string, nullable — Optional. When absent the rendered PDF falls back to the enterprise contact's legal name.

## Response `200`

The rendered LOA PDF.

## Other responses

- `400` — An error occurred. The response carries the standard Telnyx error envelope.
- `404` — An error occurred. The response carries the standard Telnyx error envelope.

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/versions/8f5f4e537994/schema)