Verify a phone number

Changed on Mar 10, 2026

Use code to verify a phone number

post/v2/verified-resources/phones/verification-code/verify

Request

The document declares no server URL.
Auth
none declared. Required headers: Authorization

Headers

Authorizationstring required

value must be Bearer <token> where <token> is api key prefixed with cal_ or managed user access token

Request body

phonestring required

phone number to verify.

codestring required

verification code sent to the phone number to verify

Example request

{
  "phone": "+37255556666",
  "code": "1ABG2C"
}

Response

status'success' | 'error' required

Example response

{
  "status": "success",
  "data": {
    "id": 789,
    "phoneNumber": "+37255556666",
    "userId": 45
  }
}

Changes

Mar 10, 2026v2ba131b4bbebb Revision changes
- breaking
  removed the required property / from the response with the status
- breaking
  removed the required property / from the response with the status
- breaking
  removed the required property / from the response with the status
- breaking
  removed the required property / from the response with the status
- breaking
  removed the required property / from the response with the status
- breaking
  removed the required property / from the response with the status
- breaking
  removed the required property / from the response with the status
- breaking
  removed the required property / from the response with the status
- breaking
  removed the required property / from the response with the status
- warning
  removed the optional property / from the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
Sep 26, 2025v2daa3e48bc03a Revision changes
- breaking
  removed the required property / from the response with the status
- breaking
  removed the required property / from the response with the status
- info
  added the optional property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status

Operation history