---
title: "List verified caller IDs allowed for outbound calls"
method: GET
path: "/allowed_caller_ids"
tags: ["Allowed-Caller-IDs"]
---

# List verified caller IDs allowed for outbound calls

`GET /allowed_caller_ids`

## Request

- Base URL: `https://api.commpeak.com/portal`
- URL: `https://api.commpeak.com/portal/allowed_caller_ids`
- Auth: API key in header `Authorization`

Returns the customer's verified Caller IDs (CLIs) that may be used for outbound calls. When `locked` is `true`, the customer may only call using the listed Caller IDs; when `false`, any Caller ID is allowed. `limitations.capacity` maps a Caller ID to its maximum concurrent call capacity and contains only numbers with a capacity limit. `caller_ids` lists every Caller ID of the account, including those still waiting for verification, with the `id` used to verify or delete it.

## Response `200`

Successful Response

- AllowedCallerIdsResponse: Envelope returned by `GET /portal/allowed_caller_ids`.
  - `locked` boolean, required: Whether outbound calls are restricted to the listed caller IDs; `false` means any caller ID is allowed.
  - `allowed_caller_ids` string[], required: Verified caller IDs (CLIs), E.164 (no leading "+").
  - `limitations` AllowedCallerIdLimitations: Per-caller-ID limits. Only caller IDs that carry a limit are listed.
    - `capacity` object, nullable: Maximum concurrent call capacity keyed by caller ID (only caller IDs with a capacity limit are included).
  - `caller_ids` CallerIdItem[], nullable: All Caller IDs of the account, including those waiting for verification, with the `id` used to verify or delete them.
    - `id` integer, required: Caller ID identifier, used to verify or delete it.
    - `cli` string, required: Caller ID number, E.164 (no leading "+").
    - `verified` boolean, required: Whether the Caller ID is verified.
    - `created_at` string, nullable: When the Caller ID was added (ISO 8601).

---

[API](https://skmtc.dev/commpeak/apis/commpeak-portal-api.md) - [All operations](https://skmtc.dev/commpeak/apis/commpeak-portal-api/llms.txt) - [OpenAPI document](https://skmtc.dev/commpeak/apis/commpeak-portal-api/revisions/df57b0c16367?raw)