v52

OpenAPI 3.1.0raw.githubusercontent.com2026-07-311,1941,9384.1 MB

Display Identity Records

Render the Branded Calling LOA for a DIR

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.

post/dir/{dir_id}/loa

Path parameters

dir_idstring uuid required

The DIR id.

Request body

phone_numbersstring[] required

Telephone numbers to authorize on the DIR, in +E164 format (+ followed by 10-15 digits). Max 15 per request.

Example request

{
  "agent": {
    "contact_phone": "+13125550000",
    "country": "US"
  },
  "phone_numbers": [
    "+13125550000"
  ]
}

Response

The rendered LOA PDF.