---
title: "Verify a Caller ID with the code from the verification call"
method: PUT
path: "/allowed_caller_ids/verify"
tags: ["Allowed-Caller-IDs"]
---

# Verify a Caller ID with the code from the verification call

`PUT /allowed_caller_ids/verify`

## Request

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

Submits the verification code read out by the verification call. The Caller ID is identified either by its `id` or by its `cli` (E.164). After 5 wrong codes a new verification call must be requested. Returns 404 when the Caller ID is not found and 422 with `errors` when the code is wrong.

## Request body

- AllowedCallerIdVerifyRequest: Body of `PUT /portal/allowed_caller_ids/verify`. Identify the Caller ID by `id` or `cli`.
  - `id` integer, nullable: Caller ID identifier (or use `cli`).
  - `cli` string, nullable: Caller ID in E.164 format (or use `id`).
  - `code` string, required: Verification code read out by the verification call.

## Response `200`

Successful Response

- CallerIdResponse: Envelope returned when a Caller ID is added or verified.
  - `caller_id` CallerIdItem, required: A Caller ID of the account, verified or still waiting for verification.
    - `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).

## Other responses

- `422`: Validation Error

---

[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)