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>"
}
'import requests
url = "https://public-api.lonescale.com/verify-phone"
payload = {
"phone": "<string>",
"webhook_url": "<string>",
"firstname": "<string>",
"lastname": "<string>",
"country": "<string>",
"city": "<string>",
"state": "<string>",
"zipcode": "<string>",
"address": "<string>"
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
phone: '<string>',
webhook_url: '<string>',
firstname: '<string>',
lastname: '<string>',
country: '<string>',
city: '<string>',
state: '<string>',
zipcode: '<string>',
address: '<string>'
})
};
fetch('https://public-api.lonescale.com/verify-phone', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://public-api.lonescale.com/verify-phone",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'phone' => '<string>',
'webhook_url' => '<string>',
'firstname' => '<string>',
'lastname' => '<string>',
'country' => '<string>',
'city' => '<string>',
'state' => '<string>',
'zipcode' => '<string>',
'address' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://public-api.lonescale.com/verify-phone"
payload := strings.NewReader("{\n \"phone\": \"<string>\",\n \"webhook_url\": \"<string>\",\n \"firstname\": \"<string>\",\n \"lastname\": \"<string>\",\n \"country\": \"<string>\",\n \"city\": \"<string>\",\n \"state\": \"<string>\",\n \"zipcode\": \"<string>\",\n \"address\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://public-api.lonescale.com/verify-phone")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"phone\": \"<string>\",\n \"webhook_url\": \"<string>\",\n \"firstname\": \"<string>\",\n \"lastname\": \"<string>\",\n \"country\": \"<string>\",\n \"city\": \"<string>\",\n \"state\": \"<string>\",\n \"zipcode\": \"<string>\",\n \"address\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://public-api.lonescale.com/verify-phone")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"phone\": \"<string>\",\n \"webhook_url\": \"<string>\",\n \"firstname\": \"<string>\",\n \"lastname\": \"<string>\",\n \"country\": \"<string>\",\n \"city\": \"<string>\",\n \"state\": \"<string>\",\n \"zipcode\": \"<string>\",\n \"address\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{}{
"message": "Bad request",
"error": "Bad request",
"statusCode": 400
}{
"message": "Invalid API Key",
"error": "Unauthorized",
"statusCode": 401
}API Enrichment
Verify Phone Number
Verify Phone Numbers [Special Access Required]
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>"
}
'import requests
url = "https://public-api.lonescale.com/verify-phone"
payload = {
"phone": "<string>",
"webhook_url": "<string>",
"firstname": "<string>",
"lastname": "<string>",
"country": "<string>",
"city": "<string>",
"state": "<string>",
"zipcode": "<string>",
"address": "<string>"
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
phone: '<string>',
webhook_url: '<string>',
firstname: '<string>',
lastname: '<string>',
country: '<string>',
city: '<string>',
state: '<string>',
zipcode: '<string>',
address: '<string>'
})
};
fetch('https://public-api.lonescale.com/verify-phone', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://public-api.lonescale.com/verify-phone",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'phone' => '<string>',
'webhook_url' => '<string>',
'firstname' => '<string>',
'lastname' => '<string>',
'country' => '<string>',
'city' => '<string>',
'state' => '<string>',
'zipcode' => '<string>',
'address' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://public-api.lonescale.com/verify-phone"
payload := strings.NewReader("{\n \"phone\": \"<string>\",\n \"webhook_url\": \"<string>\",\n \"firstname\": \"<string>\",\n \"lastname\": \"<string>\",\n \"country\": \"<string>\",\n \"city\": \"<string>\",\n \"state\": \"<string>\",\n \"zipcode\": \"<string>\",\n \"address\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://public-api.lonescale.com/verify-phone")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"phone\": \"<string>\",\n \"webhook_url\": \"<string>\",\n \"firstname\": \"<string>\",\n \"lastname\": \"<string>\",\n \"country\": \"<string>\",\n \"city\": \"<string>\",\n \"state\": \"<string>\",\n \"zipcode\": \"<string>\",\n \"address\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://public-api.lonescale.com/verify-phone")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"phone\": \"<string>\",\n \"webhook_url\": \"<string>\",\n \"firstname\": \"<string>\",\n \"lastname\": \"<string>\",\n \"country\": \"<string>\",\n \"city\": \"<string>\",\n \"state\": \"<string>\",\n \"zipcode\": \"<string>\",\n \"address\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{}{
"message": "Bad request",
"error": "Bad request",
"statusCode": 400
}{
"message": "Invalid API Key",
"error": "Unauthorized",
"statusCode": 401
}Authorizations
Provide your API key in the x-api-key header.
Body
application/json
Phone number to verify, in E.164 format.
Webhook endpoint to receive verification status for a phone number
First name of the person to verify.
Last name of the person to verify.
Country code of the phone number to verify. Increase result coverage and accuracy by 25%.
City of the phone number to verify.
State code of the phone number to verify. Increase result coverage and accuracy by 25%.
Zipcode of the phone number to verify. Increase result coverage and accuracy by 25%.
Address of the person to verify.
⌘I

