Activation V2
SMSPVA / API REFERENCE
Country number counts
Check available numbers for one country.
SMSPVA API
Authentication
| Name | Location | Type | Required | Description |
|---|---|---|---|---|
apikey | header | string | Yes | Your API key |
Parameters
| Name | Location | Type | Required | Description |
|---|---|---|---|---|
country | path | string | Yes | Country 2 symbols name in ISO 3166-2 format, uppercase. Countries list |
No request body is required.
How to use this method
Send country to see available numbers grouped by operator and service. Choose the code from the country list, then compare operator prices before ordering.
Request examples
Runtime requirements and environment setup. cURL uses a POSIX shell. JavaScript and TypeScript run in Node.js. Java uses the standard HTTP client and prints raw JSON; use your application’s JSON library to inspect the body.
: "${SMSPVA_API_KEY:?Set SMSPVA_API_KEY}"
curl --fail-with-body --max-time 30 --request GET \
--url "https://api.smspva.com/activation/countnumbers/UK" \
--header "apikey: $SMSPVA_API_KEY"Responses
The examples below show the response format. Prices, stock and account values are sample data; use the API response for current values.
| HTTP | Description |
|---|---|
| 200 | Successful operation |
HTTP 200
Successful operation
Illustrative response
{
"statusCode": 200,
"data": [
{
"operator": "Primetel_CY",
"country": "CY",
"services": [
{
"service": "opt0",
"total": 12
}
]
}
]
}Response fields
| Name | Type | Description |
|---|---|---|
statusCode | integer | Result status code |
data | array<object> | Response data |
data[].operator | string | Operator |
data[].country | string | Country |
data[].services | array<object> | |
data[].services[].service | string | Service |
data[].services[].total | integer | Numbers count |
Related guides
If a connection fails during an order-changing request, check the order before trying again.