---
title: "List a DIR's authorized BPOs"
method: GET
path: "/dir/{dir_id}/bpo_authorizations"
tags: ["Display Identity Records"]
---

# List a DIR's authorized BPOs

`GET /dir/{dir_id}/bpo_authorizations`

## Request

- Base URL: `https://api.telnyx.com/v2`
- URL: `https://api.telnyx.com/v2/dir/{dir_id}/bpo_authorizations`
- Auth: HTTP bearer

List the BPO (Business Process Outsourcer) accounts a Brand Owner has authorized on this DIR, together with the review state of each authorization.

Authorizations are supplied as the `bpo_authorizations` array when creating or updating a DIR, and each one is reviewed on its own. Only an `approved` authorization adds that BPO to this DIR's authorized callers in the branded calling registry; `pending` and `rejected` authorizations do not. Each entry includes the `loa_document_id` you submitted: because `bpo_authorizations` replaces the whole list on every DIR update, send each entry you want to keep back with its `loa_document_id` unchanged, and it keeps its review state. A rejected entry carries a `rejection_reason`. Returns an empty list when the DIR has authorized no BPOs.

## Path parameters

- `dir_id` string, uuid, required

## Query parameters

- `page[number]` integer
- `page[size]` integer

## Response `200`

Paginated list of the DIR's BPO authorizations.

- BpoAuthorizationList: Paginated list of a DIR's BPO authorizations.
  - `data` BpoAuthorization[], required
    - `record_type` 'bpo_authorization', required: Always `bpo_authorization`.
    - `bpo_enterprise_id` string, uuid, required: The authorized BPO account's enterprise id.
    - `status` 'pending' | 'approved' | 'rejected', required: Review state of this authorization. `pending` when the authorization is first added, or when you send a different `loa_document_id` for this BPO in `bpo_authorizations` (uploading a document alone changes nothing). Approving the DIR approves its pending authorizations; an admin can also approve or reject one on its own. Only an `approved` authorization adds the BPO to this DIR's authorized callers in the branded calling registry.
    - `loa_document_id` string, uuid, required: Id of the signed Letter of Authorization document submitted for this BPO. Send it back unchanged in `bpo_authorizations` when updating the DIR to keep this authorization and its review state.
    - `rejection_reason` string, nullable: Why the authorization was rejected. `null` unless `status` is `rejected`.
  - `meta` BrandedCallingPaginationMeta, required: JSON:API pagination metadata returned with every paginated list response. Page numbering is 1-based. `page_size` reports the number of items actually returned in `data` for this page; the requested size is taken from the `page[size]` query parameter.
    - `total_pages` integer, required: Total number of pages available given the current `page_size`.
    - `total_results` integer, required: Total number of items across all pages (excludes soft-deleted rows).
    - `page_number` integer, required: 1-based index of this page. Echoes the `page[number]` query parameter (default `1`).
    - `page_size` integer, required: Number of items returned in this page's `data` array. Capped at 250.

## Other responses

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

## Changes

> 152 revisions in range; 1 not diffed.

- **2026-10-01** `27a8076ac294`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/changes/dir/:dir_id/bpo_authorizations/get.md)

---

[API](https://skmtc.dev/team-telnyx/apis/telnyx-api-2.md) - [All operations](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/revisions/f82938f53ff4?raw)