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 phone through file upload.
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 perline, 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?%20secret=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?%20secret=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:
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?%20secret=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",
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 Guarantee
The validation process Verify550 provides 99% accurate results in real-time. With our proprietary “Carrier-Direct Line Intelligence”Ā we provide detailed validation status.
