SMSPVAdevelopers
Activation V2
SMSPVA / API REFERENCE

All number counts

Read available number counts grouped by country, operator and service.

SMSPVA API
GEThttps://api.smspva.com/activation/countnumbers

Authentication

NameLocationTypeRequiredDescription
apikeyheaderstringYesYour 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.

HTTPDescription
200Successful operation
402API rate limit exceeded.
HTTP 200

Successful operation

Illustrative response

{
  "statusCode": 200,
  "data": [
    {
      "operator": "Primetel_CY",
      "country": "CY",
      "services": [
        {
          "service": "opt0",
          "total": 12
        }
      ]
    }
  ]
}

Response fields

NameTypeDescription
statusCodeintegerResult status code
dataarray<object>Response data
data[].operatorstringOperator
data[].countrystringCountry
data[].servicesarray<object>
data[].services[].servicestringService
data[].services[].totalintegerNumbers count
HTTP 402

API rate limit exceeded.

Illustrative response

{
  "statusCode": 402,
  "error": {
    "type": "RATELIMIT_EXCEED",
    "description": "Rate limit exceeded."
  }
}

Response fields

NameTypeDescription
statusCodeinteger
errorobject
error.typestring
error.descriptionstring

If a connection fails during an order-changing request, check the order before trying again.

On this page