Verified Numbers

Request phone number verification

Changed on

Initiates phone number verification procedure. Supports DTMF extension dialing for voice calls to numbers behind IVR systems.

post/verified_numbers

Request

  • Base URL: https://api.telnyx.com/v2
  • URL: https://api.telnyx.com/v2/verified_numbers
  • Auth: HTTP bearer

Request body

phone_numberstring required
verification_method'sms' | 'call' required

Verification method.

extensionstring

Optional DTMF extension sequence to dial after the call is answered. This parameter enables verification of phone numbers behind IVR systems that require extension dialing. Valid characters: digits 0-9, letters A-D, symbols * and #. Pauses: w = 0.5 second pause, W = 1 second pause. Maximum length: 50 characters. Only works with 'call' verification method.

Example request

{
  "phone_number": "+15551234567",
  "verification_method": "sms",
  "extension": "ww243w1"
}

Response

Expected response to a valid request.

phone_numberstring
verification_methodstring

Example response

{
  "phone_number": "+15551234567",
  "verification_method": "sms"
}

Changes

  • 19db5ee4ec59Revision changes
    • breaking

      the // response's property type changed from integer to string, and format from int32 to no format for status

    • breaking

      the // response's property type changed from integer to string, and format from int32 to no format for status

    • breaking

      the // response's property type changed from integer to string, and format from int32 to no format for status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

  • a6a61a29ecddRevision changes
    • breaking

      the // response's property type changed from string to integer, and format from no format to int32 for status

    • breaking

      the // response's property type changed from string to integer, and format from no format to int32 for status

    • breaking

      the // response's property type changed from string to integer, and format from no format to int32 for status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status