---
title: Validating phone numbers using the Verify550 API
description: 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…
url: "https://stage.verify550.com/documentation/validating-phone-numbers-using-the-verify550-api-2/"
updated: "2025-10-11"
category: Phone Validation
---

# Validating phone numbers using the Verify550 API

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](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**):

```python

curl --request POST 
--url 'https://app.verify550.com/api/bulkPhoneList?
secret=YOUR_API_KEY&amp;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**

```python
import http.client
conn = http.client.HTTPSConnection("app.verify550.com")
payload = "rnContent-Disposition: form-data; name="file_contents"; filename="phone_list.csv"rnContent-Type: text/csvrnrnrn--rn"
headers = { 'content-type': "multipart/form-data;" }
conn.request("POST", "/api/bulkPhoneList?%20secret=YOUR_API_KEY&amp;filename=phone_list_upload.csv", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```

**Ruby**

```python

require 'uri'
require 'net/http'
require 'openssl' url = URI("https://app.verify550.com/api/bulkPhoneList?%20secret=YOUR_API_KEY&amp;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 = "rnContent-Disposition: form-data; name="file_contents"; filename="phone_list.csv"rnContent-Type: text/csvrnrnrnrn"
response = http.request(request) puts response.read_body
```

**PHP**

```php

&lt;?php
$curl = curl_init(); curl_setopt_array($curl, [ CURLOPT_URL =&gt; "https://app.verify550.com/api/bulkPhoneList?%20secret=YOUR_API_KEY&amp;filename=phone_list_upload.csv",
CURLOPT_RETURNTRANSFER =&gt; true,
CURLOPT_ENCODING =&gt; "",
CURLOPT_MAXREDIRS =&gt; 10,
CURLOPT_TIMEOUT =&gt; 30,
CURLOPT_HTTP_VERSION =&gt; CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST =&gt; "POST",
CURLOPT_POSTFIELDS =&gt; "rnContent-Disposition: form-data; name="file_contents"; filename="phone_list.csv"rnContent-Type: text/csv--rn",
CURLOPT_HTTPHEADER =&gt; [ "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:

```python
 { "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:

```python

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:UsersuserDownloads100phonescsv.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:

```python
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:UsersuserDownloads100phonescsv.csv'</pre>
```

Response:

```python
{ "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.
