Number verification
Verify a number (simple)
POST
https://api.smsedge.com/v1/verify/number-simple/Checks the format of a phone number and returns it in international format, free of charge.
This check uses numbering rules only. It does not contact the network, so it cannot tell if the number is active. To check that a number is active, use Verify a number (HLR).
The API removes all characters that are not digits from number. If you do not send country_id, the API finds the country from the international prefix.
Body params (form)
numberstringrequiredPhone number in international or local format.
country_idstringoptionalSMSEdge country ID or ISO 3166-1 alpha-2 code. Send it for numbers in local format.
Responses
- 200The number is valid.
- 400The number is missing or not valid, or the country is not known.
curl -X POST "https://api.smsedge.com/v1/verify/number-simple/" \
-H "X-API-KEY: YOUR_API_KEY" \
--data-urlencode "number=447700900123"[
{
"success": true,
"data": {
"normalized_number": "447700900123",
"national_number": "7700900123",
"country_id": 225,
"country_name": "United Kingdom"
},
"errors": [],
"response": {
"code": 200,
"description": "OK",
"date": "2026-11-16 14:40:00"
},
"api": {
"version": "v1",
"module": "verify",
"function": "number-simple"
},
"user": {
"id": 12345
}
}
]All requests need your API key in the X-API-KEY header. See Authentication.