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.