Developer API
The public API is one endpoint and GET requests only: the method name goes in the action parameter. The format matches the popular marketplaces, so existing code starts working once you change the base URL.
| Method | Key | Parameters |
|---|---|---|
| getPrices | key required | action, api_key, [country], [service] |
| getCountries | key required | action, api_key |
| getServicesList | key required | action, api_key, [country] |
| getBalance | key required | action, api_key |
| getNumber | key required | action, api_key, country, service, [duration], [maxPrice], [softId] |
| getNumberV2 | key required | action, api_key, country, service, [duration], [maxPrice], [softId] |
| getStatus | key required | action, api_key, id |
| getCurrentActivationsList | key required | action, api_key |
| setStatus | key required | action, api_key, id, status |
getPrices
key requiredPrices and stock by country and service — how many numbers there are and at what price.
| Parameter | Type | Required | Description |
|---|---|---|---|
| action | string | required | Method name: getPrices |
| api_key | string | required | The access key from your cabinet |
| country | string | no | Country identifier, e.g. 43 |
| service | string | no | Service code, e.g. wa |
GET https://sim-aggregator.org/stubs/handler_api.php ?action=getPrices&api_key=YOUR_API_KEY&country=43
{
"43": {
"wa": { "cost": 0.5, "count": 100 },
"tg": { "cost": 0.71, "count": 250 }
}
}getCountries
key requiredThe country reference: identifier, names and which modes the country supports.
| Parameter | Type | Required | Description |
|---|---|---|---|
| action | string | required | Method name: getCountries |
| api_key | string | required | The access key from your cabinet |
GET https://sim-aggregator.org/stubs/handler_api.php ?action=getCountries&api_key=YOUR_API_KEY
{
"43": { "id": 43, "rus": "DE", "eng": "DE", "chn": "DE",
"visible": 1, "retry": 1, "rent": 0, "multiService": 0 }
}getServicesList
key requiredThe service reference: the service code and its name.
| Parameter | Type | Required | Description |
|---|---|---|---|
| action | string | required | Method name: getServicesList |
| api_key | string | required | The access key from your cabinet |
| country | string | no | Country identifier, e.g. 43 |
GET https://sim-aggregator.org/stubs/handler_api.php ?action=getServicesList&api_key=YOUR_API_KEY
{
"status": "success",
"services": [
{ "code": "tg", "name": "Telegram" },
{ "code": "wa", "name": "WhatsApp" }
]
}getBalance
key requiredThe account balance.
| Parameter | Type | Required | Description |
|---|---|---|---|
| action | string | required | Method name: getBalance |
| api_key | string | required | The access key from your cabinet |
GET https://sim-aggregator.org/stubs/handler_api.php ?action=getBalance&api_key=YOUR_API_KEY
ACCESS_BALANCE:12.50
getNumber
key requiredOrder a number. The reply carries the activation id and the number.
| Parameter | Type | Required | Description |
|---|---|---|---|
| action | string | required | Method name: getNumber |
| api_key | string | required | The access key from your cabinet |
| country | string | required | Country identifier, e.g. 43 |
| service | string | required | Service code, e.g. wa |
| duration | string | no | Order duration: activation — a one-time activation (default); d1, d3, d7 — rent the number for 1, 3 or 7 days |
| maxPrice | string | no | Price ceiling per number. We will not buy above it: instead of an order you get WRONG_MAX_PRICE or NO_NUMBERS |
| softId | string | no | Software identifier, up to 255 characters |
GET https://sim-aggregator.org/stubs/handler_api.php ?action=getNumber&api_key=YOUR_API_KEY&country=43&service=wa
ACCESS_NUMBER:12345:380991234567
getNumberV2
key requiredOrder a number — the same as getNumber, but the successful reply is JSON with the price, the country and the activation time.
| Parameter | Type | Required | Description |
|---|---|---|---|
| action | string | required | Method name: getNumberV2 |
| api_key | string | required | The access key from your cabinet |
| country | string | required | Country identifier, e.g. 43 |
| service | string | required | Service code, e.g. wa |
| duration | string | no | Order duration: activation — a one-time activation (default); d1, d3, d7 — rent the number for 1, 3 or 7 days |
| maxPrice | string | no | Price ceiling per number. We will not buy above it: instead of an order you get WRONG_MAX_PRICE or NO_NUMBERS |
| softId | string | no | Software identifier, up to 255 characters |
GET https://sim-aggregator.org/stubs/handler_api.php ?action=getNumberV2&api_key=YOUR_API_KEY&country=43&service=wa
{
"activationId": 12345,
"phoneNumber": "380991234567",
"activationCost": 0.50,
"currency": 840,
"countryCode": "43",
"canGetAnotherSms": "1",
"activationTime": "2026-07-31 12:00:00",
"activationOperator": "any"
}getStatus
key requiredActivation status: still waiting for the code, or the code has arrived.
| Parameter | Type | Required | Description |
|---|---|---|---|
| action | string | required | Method name: getStatus |
| api_key | string | required | The access key from your cabinet |
| id | string | required | The activation id from getNumber |
GET https://sim-aggregator.org/stubs/handler_api.php ?action=getStatus&api_key=YOUR_API_KEY&id=12345
STATUS_OK:123456
getCurrentActivationsList
key requiredActive orders for the key: numbers that are still waiting for a code or have already received it.
| Parameter | Type | Required | Description |
|---|---|---|---|
| action | string | required | Method name: getCurrentActivationsList |
| api_key | string | required | The access key from your cabinet |
GET https://sim-aggregator.org/stubs/handler_api.php ?action=getCurrentActivationsList&api_key=YOUR_API_KEY
[
{
"numberid": 12345,
"number": "380991234567",
"status": 0
}
]setStatus
key requiredChange the activation: ask for another code, finish it, or cancel it.
| Parameter | Type | Required | Description |
|---|---|---|---|
| action | string | required | Method name: setStatus |
| api_key | string | required | The access key from your cabinet |
| id | string | required | The activation id from getNumber |
| status | string | required | The new state of the activation: 3, 6 or 8 |
GET https://sim-aggregator.org/stubs/handler_api.php ?action=setStatus&api_key=YOUR_API_KEY&id=12345&status=6
ACCESS_ACTIVATION