How to upload numbers (CSV/API)
You can verify phone numbers with Numberyo using two main methods: CSV file upload via the web interface, or API calls for developers.
Here’s how each method works.
1. Uploading a CSV file
From your dashboard, you can upload a list of numbers for bulk verification.
File requirements:
-
Format:
.csvfile (no header) -
The phone numbers must be in the first column
-
Multiple columns are allowed, but only the first one is processed
-
Maximum file size: 4 MB
Verification types:
When uploading your file, you can choose between:
-
Lookup (format and structure check)
-
HLR (network reachability check)
Processing and results:
-
You can upload multiple files at the same time
-
The system processes your file within seconds
-
Results are available directly in your dashboard
-
You can also download the results in CSV format
2. Using the API
For developers, Numberyo offers a simple and secure API. You can perform real-time verification programmatically from your systems.
Key points:
-
Only one number per API request (bulk mode is not available yet)
-
API returns a response in JSON format
-
You can choose either Lookup or HLR when making the request
Authentication:
To use the API, you must generate a personal token from your account dashboard (under the "API" tab).
Include your token in the request header:
Documentation:
You can find full API details and code examples here:
https://www.numberyo.tech/docs