COcommpeak
Allowed-Caller-IDs

Verify a Caller ID with the code from the verification call

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.

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

Request body

idinteger nullable

Caller ID identifier (or use cli).

clistring nullable

Caller ID in E.164 format (or use id).

codestring required

Verification code read out by the verification call.

Example request

{
  "cli": "12125551234",
  "code": "4821"
}

Response

Successful Response

Example response

{
  "caller_id": {
    "cli": "12125551234",
    "created_at": "2026-10-21T10:00:00.000Z",
    "id": 42,
    "verified": false
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.