Our API can be integrated into your web applications to validate phone numbers in real time. Using the API requires only a few lines of code.
Developer API Verify550 provides a developer API to integrate the phone validation process with your service. Our API provides the ability to check individual phone numbers and can accept a list of phone numbers through file upload.
Single Phone Verification & Related API Endpoints
In addition to bulk list uploads, Verify550 supports individual phone number verification. This lets you check a single phone number directly through the API and get the validation result back immediately, without having to upload a file.
Related endpoints have also been added to support combined contact validation, so a single request can validate an email address and a phone number together. Both the single phone endpoint and the combined contact endpoint use the same authentication, credit usage, and activity tracking behavior as the rest of the Verify550 API, so results, credit consumption, and usage history stay consistent with your other Verify550 requests.
How to Test Single Phone Verification
The single phone endpoint can be tested directly using a valid Verify550 API key. It accepts the phone number as a query parameter and returns the validation result immediately.
Endpoint: GET https://api.verify550.com/api/singlePhone
Parameters:
secret(string, Required): Your Verify550 API Key.phone(string, Required): The phone number to validate.
Example (cURL):
curl --request GET \ --url 'https://api.verify550.com/api/singlePhone?secret=YOUR_API_KEY&phone=2025550100'
Replace YOUR_API_KEY with a valid Verify550 API key and the phone value with the number you want to validate. The API returns the phone validation result immediately in the response.
You can also test the endpoint with different common phone formats (e.g. with or without country code, dashes, spaces, or parentheses) to confirm that the number is normalized correctly before validation.
Combined Contact Verification
Use the contact verification endpoint when you need to validate both an email address and a phone number in the same request. This lets you confirm both contact points through a single API call instead of two separate ones.
Endpoint: GET https://api.verify550.com/api/verifyContact
Parameters:
secret(string, Required): Your Verify550 API Key.email(string, Required): The email address to validate.phone(string, Required): The phone number to validate.
Example (cURL):
curl --request GET \ --url 'https://api.verify550.com/api/verifyContact?secret=YOUR_API_KEY&[email protected]&phone=2025550100'
Replace YOUR_API_KEY, the email value, and the phone value with your API key, the email address, and the phone number you want to validate. The response returns the validation result for both the email address and the phone number.
Both the single phone endpoint and the combined contact endpoint draw from the same credit pool and are logged in your account’s activity/usage history the same way as bulk validations.
Bulk Phone List Upload (/bulkPhoneList)
Submits a list of phone numbers contained within a file for bulk validation.
- Method: POST
- Endpoint: https://app.verify550.com/api/bulkPhoneList
- Authentication: Uses API Key passed as a query parameter.
Parameters:
Query Parameters:
secret (string, Required): Your Verify550 API Key.
filename (string, Required): The name you want the uploaded file to have (e.g., my_phones.csv, list_to_validate.txt).
Form Data (multipart/form-data):
file_contents (file, Required): The actual file containing the phone numbers list (one per line, ensure correct column formatting if applicable as per section 14).
Example Request (cURL):
curl --request POST \ --url 'https://app.verify550.com/api/bulkPhoneList?secret=YOUR_API_KEY&filename=phone_list_upload.csv' \ --header 'content-type: multipart/form-data' \ --form 'file_contents=@/path/to/your/local/phone_list.csv'
We also provide other example requests:
Python
import http.client
conn = http.client.HTTPSConnection("app.verify550.com")
payload = "\r\nContent-Disposition: form-data; name=\"file_contents\"; filename=\"phone_list.csv\"\r\nContent-Type: text/csv\r\n\r\n\r\n--\r\n"
headers = { 'content-type': "multipart/form-data;" }
conn.request("POST", "/api/bulkPhoneList?secret=YOUR_API_KEY&filename=phone_list_upload.csv", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
Ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://app.verify550.com/api/bulkPhoneList?secret=YOUR_API_KEY&filename=phone_list_upload.csv")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE
request = Net::HTTP::Post.new(url)
request["content-type"] = 'multipart/form-data;'
request.body = "\r\nContent-Disposition: form-data; name=\"file_contents\"; filename=\"phone_list.csv\"\r\nContent-Type: text/csv\r\n\r\n\r\n\r\n"
response = http.request(request)
puts response.read_body
PHP
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.verify550.com/api/bulkPhoneList?secret=YOUR_API_KEY&filename=phone_list_upload.csv",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => "\r\nContent-Disposition: form-data; name=\"file_contents\"; filename=\"phone_list.csv\"\r\nContent-Type: text/csv\r\n\r\n\r\n--\r\n",
CURLOPT_HTTPHEADER => [ "content-type: multipart/form-data;" ],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
Example Success Response:
Upon successful submission, the API will likely return a JSON response similar to the email bulk upload, containing an identifier for the submitted job:
{
"success": true,
"message": "File uploaded successfully for phone validation.",
"id": "unique_job_id",
"filename": "phone_list_upload.csv"
}
Our API now includes full multicolumn support.
Example:
curl --request POST \ --url 'https://app.verify550.com/api/bulkPhoneList?secret=API_KEY&filename=example.csv' \ --header 'content-type: multipart/form-data' \ --form 'file_contents=@C:\Users\user\Downloads\100phonescsv.csv'
{
"success": false,
"message": "We have detected more phone numbers in your list than expected. Please using the 'column' param to send the name of the column you want to verify."
}
The API call including column will be:
curl --request POST \ --url 'https://app.verify550.com/api/bulkPhoneList?secret=API_KEY&filename=example.csv&column=phone1' \ --header 'content-type: multipart/form-data' \ --form 'file_contents=@C:\Users\user\Downloads\100phonescsv.csv'
Response:
{ "success": true, "id": 11532, "job_id": 1747065679, "message": "", "filename": "100phonescsv.csv" }
Our Guarantee
The validation process Verify550 provides 99% accurate results in real-time. With our proprietary “Carrier-Direct Line Intelligence” we provide detailed validation status.
