API para desarrolladores

La API pública es un solo endpoint y solo peticiones GET: el nombre del método va en el parámetro action. El formato coincide con las plataformas populares, así que el código existente funciona con solo cambiar la URL base.

Clave de accesoObtener clave
La clave se emite en tu cuenta: inicia sesión o regístrate para obtenerla.La clave se muestra una sola vez, al emitirla. Si la pierdes, emite otra y revoca la anterior.
URL base
GEThttps://sim-aggregator.org/stubs/handler_api.php
Todos los métodos se llaman en esta dirección; solo cambia el parámetro action.
Orden de trabajo
1getPrices · getServicesListConsulta precio y stock del servicio y país que necesitas.
2getNumber · getNumberV2Pide un número: la respuesta trae el id de activación y el número.
3getStatusConsulta el estado hasta que llegue el código.
4setStatus · 6Finaliza la activación cuando el servicio acepte el código.
—setStatus · 3 · 8¿Otro código? 3. ¿El número no sirvió? 8, y el dinero vuelve.
Resumen de métodos
MétodoClaveParámetros
getPricesrequiere claveaction, api_key, [country], [service]
getCountriesrequiere claveaction, api_key
getServicesListrequiere claveaction, api_key, [country]
getBalancerequiere claveaction, api_key
getNumberrequiere claveaction, api_key, country, service, [duration], [maxPrice], [softId]
getNumberV2requiere claveaction, api_key, country, service, [duration], [maxPrice], [softId]
getStatusrequiere claveaction, api_key, id
getCurrentActivationsListrequiere claveaction, api_key
setStatusrequiere claveaction, api_key, id, status

getPrices

requiere clave

Precios y stock por país y servicio: cuántos números hay y a qué precio.

Parámetros
ParámetroTipoObligatorioDescripción
actionstringobligatorioNombre del método: getPrices
api_keystringobligatorioClave de acceso del panel
countrystringnoIdentificador del país, por ejemplo 43
servicestringnoCódigo del servicio, por ejemplo wa
Petición
GET https://sim-aggregator.org/stubs/handler_api.php
  ?action=getPrices&api_key=YOUR_API_KEY&country=43
Respuesta
{
  "43": {
    "wa": { "cost": 0.5, "count": 100 },
    "tg": { "cost": 0.71, "count": 250 }
  }
}
Sin parámetros el método devuelve todo el catálogo de precios: la respuesta es enorme, así que pide el país y el servicio que necesitas.
Qué puede responder
BAD_COUNTRYPaís no encontrado
BAD_SERVICEServicio no encontrado
BAD_KEYClave rechazada: no existe o fue revocada

getCountries

requiere clave

Catálogo de países: identificador, nombres y qué modos admite el país.

Parámetros
ParámetroTipoObligatorioDescripción
actionstringobligatorioNombre del método: getCountries
api_keystringobligatorioClave de acceso del panel
Petición
GET https://sim-aggregator.org/stubs/handler_api.php
  ?action=getCountries&api_key=YOUR_API_KEY
Respuesta
{
  "43": { "id": 43, "rus": "DE", "eng": "DE", "chn": "DE",
         "visible": 1, "retry": 1, "rent": 0, "multiService": 0 }
}
Los campos rus, eng y chn traen ahora el código ISO de dos letras del país, no su nombre.
Qué puede responder
BAD_KEYClave rechazada: no existe o fue revocada

getServicesList

requiere clave

Catálogo de servicios: código del servicio y su nombre.

Parámetros
ParámetroTipoObligatorioDescripción
actionstringobligatorioNombre del método: getServicesList
api_keystringobligatorioClave de acceso del panel
countrystringnoIdentificador del país, por ejemplo 43
Petición
GET https://sim-aggregator.org/stubs/handler_api.php
  ?action=getServicesList&api_key=YOUR_API_KEY
Respuesta
{
  "status": "success",
  "services": [
    { "code": "tg", "name": "Telegram" },
    { "code": "wa", "name": "WhatsApp" }
  ]
}
Con el parámetro country la lista se reduce a los servicios que realmente se venden allí.
Qué puede responder
BAD_COUNTRYPaís no encontrado
BAD_KEYClave rechazada: no existe o fue revocada

getBalance

requiere clave

Saldo de la cuenta.

Parámetros
ParámetroTipoObligatorioDescripción
actionstringobligatorioNombre del método: getBalance
api_keystringobligatorioClave de acceso del panel
Petición
GET https://sim-aggregator.org/stubs/handler_api.php
  ?action=getBalance&api_key=YOUR_API_KEY
Respuesta
ACCESS_BALANCE:12.50
La respuesta es una cadena, no JSON: el importe va después de los dos puntos.
Qué puede responder
BAD_KEYClave rechazada: no existe o fue revocada

getNumber

requiere clave

Pedir un número. La respuesta trae el id de activación y el número.

Parámetros
ParámetroTipoObligatorioDescripción
actionstringobligatorioNombre del método: getNumber
api_keystringobligatorioClave de acceso del panel
countrystringobligatorioIdentificador del país, por ejemplo 43
servicestringobligatorioCódigo del servicio, por ejemplo wa
durationstringnoDuración del pedido: activation — activación única (por defecto); d1, d3, d7 — alquiler del número por 1, 3 o 7 días
maxPricestringnoPrecio máximo por número. No compraremos por encima: en lugar del pedido llega WRONG_MAX_PRICE o NO_NUMBERS
softIdstringnoIdentificador del software, hasta 255 caracteres
Petición
GET https://sim-aggregator.org/stubs/handler_api.php
  ?action=getNumber&api_key=YOUR_API_KEY&country=43&service=wa
Respuesta
ACCESS_NUMBER:12345:380991234567
La respuesta es la cadena ACCESS_NUMBER:id:número. El id hace falta para getStatus y setStatus. Sin duration se pide una activación única. Con duration=d1, d3 o d7 el número se alquila y aparece en getCurrentActivationsList hasta que termina el alquiler. Si el servicio no tiene esa duración, la respuesta es BAD_SERVICE. Si se indica maxPrice y el alquiler cuesta más que ese tope, la respuesta es NO_NUMBERS, sin el precio mínimo: WRONG_MAX_PRICE:precio solo llega para activation.
Qué puede responder
NO_BALANCEEl saldo no cubre el pedido
NO_NUMBERSAhora mismo no hay números libres para esta combinación
BAD_COUNTRYPaís no encontrado
BAD_SERVICEServicio no encontrado
BAD_DURATIONValor de duration desconocido
WRONG_MAX_PRICE:PRICEEl precio supera maxPrice; tras los dos puntos va el precio más bajo para este par (solo activación única)
BAD_MAX_PRICEmaxPrice no es un número o no es mayor que cero
BAD_KEYClave rechazada: no existe o fue revocada
CHANNEL_LIMITSe alcanzó el límite de activaciones simultáneas
BAD_SOFTWARE_IDsoftId no válido
ERROR_APIError inesperado del lado del servicio

getNumberV2

requiere clave

Pedir un número: igual que getNumber, pero la respuesta correcta llega en JSON con el precio, el país y la hora de activación.

Parámetros
ParámetroTipoObligatorioDescripción
actionstringobligatorioNombre del método: getNumberV2
api_keystringobligatorioClave de acceso del panel
countrystringobligatorioIdentificador del país, por ejemplo 43
servicestringobligatorioCódigo del servicio, por ejemplo wa
durationstringnoDuración del pedido: activation — activación única (por defecto); d1, d3, d7 — alquiler del número por 1, 3 o 7 días
maxPricestringnoPrecio máximo por número. No compraremos por encima: en lugar del pedido llega WRONG_MAX_PRICE o NO_NUMBERS
softIdstringnoIdentificador del software, hasta 255 caracteres
Petición
GET https://sim-aggregator.org/stubs/handler_api.php
  ?action=getNumberV2&api_key=YOUR_API_KEY&country=43&service=wa
Respuesta
{
  "activationId": 12345,
  "phoneNumber": "380991234567",
  "activationCost": 0.50,
  "currency": 840,
  "countryCode": "43",
  "canGetAnotherSms": "1",
  "activationTime": "2026-07-31 12:00:00",
  "activationOperator": "any"
}
Solo cambia la respuesta correcta respecto a getNumber. activationTime está en UTC. Los rechazos llegan igual que en getNumber: como una cadena de texto, no como JSON.
Qué puede responder
NO_BALANCEEl saldo no cubre el pedido
NO_NUMBERSAhora mismo no hay números libres para esta combinación
BAD_COUNTRYPaís no encontrado
BAD_SERVICEServicio no encontrado
BAD_DURATIONValor de duration desconocido
WRONG_MAX_PRICE:PRICEEl precio supera maxPrice; tras los dos puntos va el precio más bajo para este par (solo activación única)
BAD_MAX_PRICEmaxPrice no es un número o no es mayor que cero
BAD_KEYClave rechazada: no existe o fue revocada
CHANNEL_LIMITSe alcanzó el límite de activaciones simultáneas
BAD_SOFTWARE_IDsoftId no válido
ERROR_APIError inesperado del lado del servicio

getStatus

requiere clave

Estado de la activación: seguimos esperando el código o ya ha llegado.

Parámetros
ParámetroTipoObligatorioDescripción
actionstringobligatorioNombre del método: getStatus
api_keystringobligatorioClave de acceso del panel
idstringobligatorioIdentificador de activación devuelto por getNumber
Petición
GET https://sim-aggregator.org/stubs/handler_api.php
  ?action=getStatus&api_key=YOUR_API_KEY&id=12345
Respuesta
STATUS_OK:123456
Qué puede responder
STATUS_WAIT_CODEEl número está entregado, aún sin código
STATUS_OK:CODECódigo recibido; al final va el código del SMS
STATUS_WAIT_RETRY:CODEEsperamos el siguiente código; al final va el código anterior
STATUS_CANCELLa activación ya está cerrada: cancelada o finalizada
NO_ACTIVATIONLa activación no existe o ya está cerrada
BAD_KEYClave rechazada: no existe o fue revocada

getCurrentActivationsList

requiere clave

Pedidos activos de la clave: números que aún esperan un código o ya lo recibieron.

Parámetros
ParámetroTipoObligatorioDescripción
actionstringobligatorioNombre del método: getCurrentActivationsList
api_keystringobligatorioClave de acceso del panel
Petición
GET https://sim-aggregator.org/stubs/handler_api.php
  ?action=getCurrentActivationsList&api_key=YOUR_API_KEY
Respuesta
[
  {
    "numberid": 12345,
    "number": "380991234567",
    "status": 0
  }
]
Un array JSON plano. status: 0 — esperando código, 3 — código recibido; los pedidos cerrados no aparecen. Sin pedidos activos — un array vacío [].
Qué puede responder
BAD_KEYClave rechazada: no existe o fue revocada
ERROR_APIError inesperado del lado del servicio

setStatus

requiere clave

Cambiar la activación: pedir otro código, finalizarla o cancelarla.

Parámetros
ParámetroTipoObligatorioDescripción
actionstringobligatorioNombre del método: setStatus
api_keystringobligatorioClave de acceso del panel
idstringobligatorioIdentificador de activación devuelto por getNumber
statusstringobligatorioNuevo estado de la activación: 3, 6 u 8
Petición
GET https://sim-aggregator.org/stubs/handler_api.php
  ?action=setStatus&api_key=YOUR_API_KEY&id=12345&status=6
Respuesta
ACCESS_ACTIVATION
Finaliza las activaciones de forma explícita: cerrar el pedido libera la ranura y cancelarlo devuelve el dinero.
Valores de status
3pedir otro código al mismo número
6finalizar la activación: el código fue aceptado
8cancelar la activación; el dinero vuelve al saldo
Qué puede responder
ACCESS_ACTIVATIONActivación finalizada
ACCESS_CANCELActivación cancelada, el dinero ha vuelto
ACCESS_RETRY_GETSolicitud aceptada: esperamos el siguiente código en el mismo número
NO_ACTIVATIONLa activación no existe o ya está cerrada
EARLY_CANCEL_DENIEDAún es pronto para cancelar: repite la solicitud más tarde
BAD_STATUSNo permitido: la activación ya está cerrada o el código ya se entregó y no se puede cancelar
BAD_KEYClave rechazada: no existe o fue revocada
ERROR_APIError inesperado del lado del servicio
Errores comunes
BAD_ACTIONNombre de método desconocido en action
BAD_KEYClave rechazada: no existe o fue revocada
NO_BALANCEEl saldo no cubre el pedido
NO_NUMBERSAhora mismo no hay números libres para esta combinación
BAD_COUNTRYPaís no encontrado
BAD_SERVICEServicio no encontrado
CHANNEL_LIMITSe alcanzó el límite de activaciones simultáneas
REQUEST_LIMITLímite de peticiones por clave superado: espere y reintente
BAD_SOFTWARE_IDsoftId no válido
BAD_STATUSValor de status no admitido
ERROR_APIError inesperado del lado del servicio
Códigos de serviciolista completa: getServicesList
waWhatsApp
tgTelegram
vkVK
goGoogle
fbFacebook
lfTikTok
igInstagram
dsDiscord
drOpenAI
aczClaude
Códigos de paíslista completa: getCountries
43Alemania
15Polonia
16Reino Unido
78Francia
86Italia
56España
2Kazajistán
62Turquía
187Estados Unidos
22India
Límites
Peticiones por clave600 por minuto (≈10 por segundo)
Consulta de estadouna cada 2–5 s por activación