All number counts
Read available number counts grouped by country, operator and service.
Authentication
| Name | Location | Type | Required | Description |
|---|---|---|---|---|
apikey | header | string | Yes | Your API key |
Parameters
No path or query parameters. No request body.
How to use this method
Check available numbers across countries, operators and services. To look up one country, use Country number counts. Compare costs with All service prices.
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" \
--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 |
| 402 | API rate limit exceeded. |
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 |
HTTP 402
API rate limit exceeded.
Illustrative response
{
"statusCode": 402,
"error": {
"type": "RATELIMIT_EXCEED",
"description": "Rate limit exceeded."
}
}Response fields
| Name | Type | Description |
|---|---|---|
statusCode | integer | |
error | object | |
error.type | string | |
error.description | string |
Related guides
If a connection fails during an order-changing request, check the order before trying again.