Collapse content

API —  this is the protocol of interaction between your software and our activation server. The API is needed to automate the process of receiving SMS messages on your side

Our API is compatible with the sms-activate API

All requests must have an API key in the form of the api_key parameter

image
Activation API
Activation API: Request a number
https://api.grizzlysms.com/stubs/handler_api.php?api_key=$api_key&action=getNumber&service=$service&country=$country&maxPrice=$maxPrice&providerIds=$providerIds&exceptProviderIds=$exceptProviderIds

&action=getNumber
$api_key — your API key (Settings);
$service — service code;
$country — country code;
$maxPrice — the maximum price for which you are ready to buy a number;
$providerIds - a list of providers from which purchases will be made, separated by commas (1,2,3)
$exceptProviderIds - a list of providers excluded from the number purchase, separated by commas (1,2,3)

Possible errors:
BAD_KEY — check your API key;
NO_NUMBERS — repeat a request or choose another country;
The service is prohibited for sale by administration — select another service;
SERVICE_UNAVAILABLE_REGION — access from your region is restricted, please use another IP.

The example of successful answer:

ACCESS_NUMBER:38496653:66846426435

Where 38496653 is activation id. 66846426435 is a phone number.

Test this method now
Your API key
Service code
Country code
Activation API
Activation API: Request a number v2
https://api.grizzlysms.com/stubs/handler_api.php?api_key=$api_key&action=getNumberV2&service=$service&country=$country&maxPrice=maxPrice&providerIds=$providerIds&exceptProviderIds=$exceptProviderIds

&action=getNumberV2

The method works similarly to the getNumber method, accepts the same parameters, but returns additional activation information.

$api_key — your API key (Settings);
$service — service code;
$country — country code;
$maxPrice — the maximum price for which you are ready to buy a number;
$providerIds - a list of providers from which purchases will be made, separated by commas (1,2,3)
$exceptProviderIds - a list of providers excluded from the number purchase, separated by commas (1,2,3)

Possible errors:
BAD_KEY — check your API key;
NO_NUMBERS — repeat a request or choose another country;
The service is prohibited for sale by administration — select another service;
SERVICE_UNAVAILABLE_REGION — access from your region is restricted, please use another IP.

The example of successful answer:

{
   "activationId": 38496653,
   "phoneNumber": "66846426435",
   "activationCost": 12.34,
   "currency": 840,
   "countryCode": "2",
   "canGetAnotherSms": "1",
   "activationTime": "2025-12-31 23:30:55"
}

Where 38496653 is activation id. 66846426435 is a phone number,
12.34 - purchase price,
870 - currency code by ISO 4217, 2 - country code,
0/1 = true/false support second sms,
2025-12-31 23:30:55 - activation start date

Test this method now
Your API key
Service code
Country code
Activation API
Activation API: Activation status changes

https://api.grizzlysms.com/stubs/handler_api.php?api_key=$api_key&action=setStatus&status=$status&id=$id

&action=setStatus

$api_key — your API key (Settings);
$id — activation id;
$status — activation status:
-1 — cancel activation
1 — inform about the readiness of the number (sms sent to the number);
3 — wait for the next code on the same number;
6 — complete activation;
8 — cancel activation.

Service responses:
ACCESS_READY — the availability of the number has been confirmed
ACCESS_RETRY_GET — waiting for a new sms
ACCESS_ACTIVATION — the service has been activated successfully
ACCESS_CANCEL — activation canceled

Possible errors:
ERROR_SQL — SQL server error
NO_ACTIVATION — the activation id does not exist
BAD_SERVICE — incorrect service name
BAD_STATUS — incorrect status
BAD_KEY — Invalid API key
BAD_ACTION — incorrect action
SERVICE_UNAVAILABLE_REGION — access from your region is restricted, please use another IP

Test this method now
Your API key
Activation id
Activation status
Activation API
Activation API: Get the activation status

https://api.grizzlysms.com/stubs/handler_api.php?api_key=$api_key&action=getStatus&id=$id

&action=getStatus
$api_key — your API key (Settings);
$id — activation id.

Service responses:
STATUS_WAIT_CODE — waiting for sms
STATUS_WAIT_RETRY:$lastcode — waiting for code refinement (where $lastcode is the last, unsuitable code)
STATUS_WAIT_RESEND — waiting for the sms to be sent again (the software must click re-send sms and perform a status change to 6)
STATUS_CANCEL — activation canceled
STATUS_OK:$code — code received (where $code is the activation code).

Possible errors:
NO_ACTIVATION — the activation id does not exist
BAD_KEY — Invalid API key
BAD_ACTION — incorrect action
SERVICE_UNAVAILABLE_REGION — access from your region is restricted, please use another IP

Test this method now
Your API key
Activation id
Activation API
Activation API: Balance Request
https://api.grizzlysms.com/stubs/handler_api.php?api_key=$api_key&action=getBalance

&action=getBalance
$api_key — your API key (Settings);

Service response:
ACCESS_BALANCE:$balance (where $balance is the account balance)

Possible errors:
BAD_KEY — Invalid API key
SERVICE_UNAVAILABLE_REGION — access from your region is restricted, please use another IP

Test this method now
Your API key
Activation API
Activation API: Get current prices by country
https://api.grizzlysms.com/stubs/handler_api.php?api_key=$api_key&action=getPrices&service=$service&country=$country

&action=getPrices
$api_key
— your API key (Settings);
$service — service code;
$country — country code.

Possible errors:
BAD_KEY — Invalid API key
SERVICE_UNAVAILABLE_REGION — access from your region is restricted, please use another IP

Service responses in the format 
For example, a request of the form https://api.grizzlysms.com/stubs/handler_api.php?api_key=YOURKEY&action=getPrices&country=0

{
  "Country": {
    "Service": {
      "cost": Cost,
      "count": Quantity
    }
  }
}
Test this method now
Your API key
Service code
Country code
Activation API
Activation API: Get current prices v2
https://api.grizzlysms.com/stubs/handler_api.php?api_key=$api_key&action=getPricesV2&service=$service&country=$country

&action=getPricesV2
$api_key
— your API key (Settings);
$service — service code;
$country — country code.

Possible errors:
BAD_KEY — Invalid API key
BAD_ACTION — incorrect action
BAD_SERVICE — incorrect service name

Service responses in the format 

  "country": {
    "service": {
            "price1": count,
            "price2": count,
            "price3": count,
          }
     },
Test this method now
Your API key
Service code
Country code
Activation API
Activation API: Get current prices v3
https://api.grizzlysms.com/stubs/handler_api.php?api_key=$api_key&action=getPricesV3&service=$service&country=$country

&action=getPricesV3
$api_key
— your API key (Settings);
$service — service code;
$country — country code.

Possible errors:
BAD_KEY — Invalid API key
BAD_ACTION — incorrect action
BAD_SERVICE — incorrect service name

Service responses in the format 

 {
  "country": {
    "service": {
      "price": price,
      "count": count,
      "providers": {
        "provider 1 id": {
          "count": count,
          "price": [price1, price2],
          "provider_id": provider_id
        },
        "provider 2 id": {
          "count": count,
          "price": [price],
          "provider_id": provider_id
        },
        "provider 3 id": {
          "count": count,
          "price": [price1, price2, price3],
          "provider_id": provider_id
        }
      }
    }
  }
}
Test this method now
Your API key
Service code
Country code
Utility API
Utility API: Get static wallet for payment
https://api.grizzlysms.com/public/crypto/wallet?api_key=$api_key&coin=usdt&network=tron

$api_key – your API-key (Settings);
$coin – coin (usdt);
$network – network number (trс-20)

The example of an answer

  {
        "wallet_address": "TReiqL2AkD1euTgjXmrtKLnwDAbNPgTstU"
    }

Test this method now
Your API-key