Verified Numbers

Request phone number verification

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

post/verified_numbers

Request body

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.

phone_numberstring required
verification_method'sms' | 'call' required

Verification method.

Example request

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

Response

Expected response to a valid request.

phone_numberstring
verification_methodstring

Example response

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

Changes

Changed in 2 of the 61 revisions of this API.633

  • 1571b0380bd733See the full diff
    • the errors/items/code response's property type/format changed from integer/int32 to string/ for status 400

      response-property-type-changed

    • the errors/items/code response's property type/format changed from integer/int32 to string/ for status 401

      response-property-type-changed

    • the errors/items/code response's property type/format changed from integer/int32 to string/ for status 422

      response-property-type-changed

    • added the optional property errors/items/meta/url to the response with the 400 status

      response-optional-property-added

    • added the optional property errors/items/meta/url to the response with the 401 status

      response-optional-property-added

    • added the optional property errors/items/meta/url to the response with the 422 status

      response-optional-property-added

    This revision also has 64 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • the errors/items/code response's property type/format changed from string/ to integer/int32 for status 400

      response-property-type-changed

    • the errors/items/code response's property type/format changed from string/ to integer/int32 for status 401

      response-property-type-changed

    • the errors/items/code response's property type/format changed from string/ to integer/int32 for status 422

      response-property-type-changed

    • removed the optional property errors/items/meta/url from the response with the 400 status

      response-optional-property-removed

    • removed the optional property errors/items/meta/url from the response with the 401 status

      response-optional-property-removed

    • removed the optional property errors/items/meta/url from the response with the 422 status

      response-optional-property-removed

    This revision also has 41 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog