SMSPVAdevelopers
Activation V2
SMSPVA / API REFERENCE

Country number counts

Check available numbers for one country.

SMSPVA API
GEThttps://api.smspva.com/activation/countnumbers/{country}

Authentication

NameLocationTypeRequiredDescription
apikeyheaderstringYesYour API key

Parameters

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

HTTPDescription
200Successful operation
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

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

On this page