Skip to main content
POST
/
verify-phone
cURL
curl --request POST \
  --url https://public-api.lonescale.com/verify-phone \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "phone": "<string>",
  "webhook_url": "<string>",
  "firstname": "<string>",
  "lastname": "<string>",
  "country": "<string>",
  "city": "<string>",
  "state": "<string>",
  "zipcode": "<string>",
  "address": "<string>"
}
'
{
  "status": "verified",
  "type": "mobile"
}

Authorizations

​
x-api-key
string
header
required

Provide your API key in the x-api-key header.

Body

application/json
​
phone
string
required

Phone number to verify, in E.164 format.

​
webhook_url
string<uri>
required

Webhook endpoint to receive verification status for a phone number

​
firstname
string
required

First name of the person to verify.

​
lastname
string
required

Last name of the person to verify.

​
country
string

Country code of the phone number to verify. Increase result coverage and accuracy by 25%.

​
city
string

City of the phone number to verify.

​
state
string

State code of the phone number to verify. Increase result coverage and accuracy by 25%.

​
zipcode
string

Zipcode of the phone number to verify. Increase result coverage and accuracy by 25%.

​
address
string

Address of the person to verify.

Response

Phone verification successfully created

​
status
enum<string>

The verification status of the phone number.

Available options:
verified,
regular,
unknown
​
type
enum<string>

The type of the phone number.

Available options:
mobile,
landline,
unknown