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 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'</pre>
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.
