SMSPVAdevelopers
Activation V2
SMSPVA / API REFERENCE

Operators

Find operator codes for a country, including donor operators.

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

Authentication

NameLocationTypeRequiredDescription
apikeyheaderstringYesYour API key

Parameters

NameLocationTypeRequiredDescription
countrypathstringYesCountry code

No request body is required.

How to use this method

Find the operators available in your chosen country. Use the returned code when requesting a number from a specific operator.

The list can include SMSPVA operators and donor operators, such as DonorAlpha_UK. Use either code in the same way. Donor numbers come from external providers and may be less consistent than SMSPVA’s own real SIM cards. A donor count of 9999 means the exact quantity is unknown; availability may be effectively unlimited.

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/operators/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
400No ApiKey found
HTTP 200

Successful operation

Illustrative response

{
  "statusCode": 200,
  "data": {
    "country": "UK",
    "operators": [
      "DonorAlpha_UK"
    ]
  }
}

Response fields

NameTypeDescription
statusCodeintegerResult status code
dataobjectResponse data
data.countrystringCountry code
data.operatorsarray<string>List of available operators
HTTP 400

No ApiKey found

Illustrative response

{
  "statusCode": 400,
  "error": {
    "type": "APIKEY_NOT_SET",
    "description": "No ApiKey found"
  }
}

Response fields

NameTypeDescription
statusCodeintegerResult status code
errorobjectError data
error.typestringError type
error.descriptionstringError description

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

On this page