Send a verification code to the user's own phone number: a text, or a call that reads the code out. Submit the code with POST /api/numbers/own/{number}/verify. At most 5 codes a day.

post/api/numbers/own

Request

  • Base URL: https://call4.me
  • URL: https://call4.me/api/numbers/own
  • Auth: HTTP bearer

Request body

numberstring required

the user's own phone number, e.g. "+14155550123" or "(415) 555-0123"

method'sms' | 'call' required

how to send the code: a text, or a call that reads it out (for landlines)

extensionstring

keys the verification call dials once answered, to get past a phone menu to an extension; w waits half a second, W one second. method "call" only

Response

The code was sent; the number waits on it

numberstring required

formatted for people

e164string required
countrystring required

ISO 3166-1 alpha-2

country_namestring required
status'pending' | 'verified' required

pending: the code was sent and has not come back yet

method'sms' | 'call' required

how the code was sent

verified_atstring nullable required

Changes

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