API propia de Get-SMS

Aqui se describe como funciona nuestra API. La API te permite integrar tus soluciones de software con nuestro servicio, acelerar el proceso de verificacion de cuentas y eliminar el trabajo manual.

Recibir el saldo del usuario

Solicitud GET o POST a la url:

https://get-sms.com/api/v1/?method=getbalance&userkey=testapikey

Parametros:
method = getbalance
userkey = YOUR_APIKEY

Respuesta:
Si la solicitud es correcta, se devuelve un json con "status" 200.
La clave "balance" del objeto "data" describe tu saldo actual:

{
"status": 200,
"data": {
"balance": 100,00
}
}

Codigos de error (status):
500 - error al procesar la consulta
401 - API KEY del usuario no especificada o incorrecta
404 - parámetro del método incorrecto

Obtener una lista de servicios y el numero de numeros disponibles

Si necesitas una lista de servicios con su cantidad actual en el sistema, usa este metodo.

Solicitud GET o POST a la url:

https://get-sms.com/api/v1/?method=getcount&userkey=testapikey&country=kazakhstan

Parametros:
method = getcount
userkey = YOUR_APIKEY
country = kazakhstan Pais. Parametro opcional. El valor por defecto es kazakhstan (Kazakhstan). La lista completa de valores de pais se puede encontrar en la "Lista de paises" seccion

Respuesta:
Si la consulta es correcta, se devuelve un json con "status" 200. El resultado es un objeto con dos claves: "status" y "data". La clave "status" caracteriza el resultado de la consulta. La clave "data" contiene el objeto con claves de operadores. Cada operador tiene un objeto que describe los servicios.
Cada objeto de servicio tiene dos claves: "count" - cantidad actual, y "price" - precio.
Esta estructura permite acceder facilmente a la informacion necesaria. Por ejemplo, tras decodificar json en PHP, puedes leer la cantidad de WhatsApp para cualquier operador asi: $decoded_json['ANY']['wapp']['count'].
Los codigos de todos los servicios se encuentran en la seccion Lista de servicios.

{
"status": 200,
"data": {
// any operator
"ANY": {
"vk": {
"count": 0,
"price": "5"
},
"ok": {
"count": 0,
"price": "5"
},
"wapp": {
"count": 1,
"price": "2"
},
"vbr": {
"count": 10,
"price": "2"
}
}
...
// Only Tele2
"TELE2": {
...
},
// Only Beeline
"BEELINE": {
...
},
// Only Megafon
"MEGAFON": {
...
},
// Only MTS
"MTS": {
...
}
}
}

Si ocurre un error durante la consulta, se devuelve un json con "status" 500. El problema se debe a un error al trabajar con la base de datos.
Si recibes este error en esta solicitud, contacta con la administracion del proyecto Get-SMS inmediatamente:

{
"status": 500,
"data": {
"msg": "Failed to generate a service count"
}
}

Codigos de error (status):
500 - error al procesar la consulta
401 - API KEY del usuario no especificada o incorrecta
404 - parámetro del método incorrecto

Obtener un numero de telefono

La parte principal del proyecto es emitir numeros de telefono para activacion. Antes de obtener un numero de telefono debes comprobar que tienes fondos suficientes en el saldo y que hay numeros libres en el sistema.
Una pequena explicacion.
Cuando se emite el numero, creamos un pedido virtual que permite recibir SMS desde el numero emitido durante 15 minutos. Durante la vida del pedido, transferimos parte de tu saldo a la reserva para evitar cargos erroneos durante el trabajo multihilo con la API y evitar que los usuarios abandonen el pedido sin recibir SMS.

Solicitud GET o POST a la url:

https://get-sms.com/api/v1/?method=getnumber&service=vk&userkey=testapikey&country=kazakhstan

Parametros:
method = getnumber
service = vk Servicio. Parametro obligatorio. La lista completa de valores de servicio se puede encontrar en la "Lista de servicios" seccion.
userkey = YOUR_APIKEY
country = kazakhstan Pais. Parametro opcional. El valor por defecto es kazakhstan (Kazakhstan). La lista completa de valores de pais se puede encontrar en la "Lista de paises" seccion

Respuesta:
Si la consulta es correcta, se obtendra un json con la clave "status" igual a 200.
La clave "data" tendra un objeto con las claves "order_id" - numero de pedido para trabajar despues con el numero de telefono, y "phone", que contiene el numero de telefono para recibir el SMS con el codigo de verificacion.
El numero de telefono esta en formato internacional con codigo de pais y sin el signo +. Tenlo en cuenta.

{
"status": 200,
"data": {
"order_id": "377253343",
"phone": "79969817867",
"start_time": "2023-02-23T13:11:57.373Z"
}
}

Puede ocurrir que temporalmente no tengamos numeros para el servicio pedido; entonces el "status" sera 500:

{
"status": 500,
"data": {
"msg": "No phone number was found for this request",
"advice": "Please try to retrieve the phone number later, after new numbers become available"
}
}

Codigos de error (status):
401 - API KEY del usuario no especificada
404 - parámetro del método incorrecto
500 - no hay números disponibles
502 - el servicio no existe
503 - el operador no existe
504 - fondos insuficientes
505 - el país no existe
506 - estás bloqueado temporalmente hasta el día siguiente
507 - mantenimiento técnico en curso

Recuperar un codigo desde un SMS

El paso final de la activacion es recibir un codigo y el texto completo del mensaje para confirmar el numero de cuenta.
El algoritmo para recibir SMS es especifico:
1. Envia una solicitud de SMS sustituyendo en order_id el valor de la solicitud getnumber.
2. Si "status" es 200, el SMS fue recibido.
3. Si "status" es 400, el SMS aun no llego o no se encontro; repite desde el paso 1 en 5 segundos.
4. Si "status" es 500, el tiempo del pedido expiro.

Que hacer si el pedido expiro y no recibiste SMS?
Esto puede deberse a varias razones:
- el servicio pedido no envio el SMS
- la plantilla de busqueda de SMS no esta actualizada
- un error durante el funcionamiento de nuestro equipo
- introdujiste un numero de telefono incorrecto por error.
En cualquier caso, no se descontara dinero de tu cuenta si no se recibio SMS.
Si estas seguro de que el error es culpa nuestra, estaremos encantados de ayudarte mediante soporte tecnico.

Solicitud GET o POST a la url:

https://get-sms.com/api/v1/?method=getcode&order_id=377253343&userkey=testapikey

Parametros:
method = getcode
order_id = 377253343 Numero de pedido obtenido de la solicitud del numero. Valor obligatorio.
userkey = YOUR_APIKEY

Respuesta:
Si la consulta se ejecuta correctamente, se recibira un json con la clave "status" igual a 200.
La clave "data" contendra el objeto con los detalles del mensaje:
code - el codigo que el sistema encontro en el mensaje. Puede ser null si no se pudo detectar
fullSms - texto completo del mensaje recibido
phone - numero de telefono al que se envio el mensaje en formato internacional sin el signo +
receivedDate - fecha de recepcion del SMS en formato ISO
sender - remitente indicado en el mensaje. Puede estar vacio.
id - identificador de SMS para el metodo wrongcode (SMS adicional como parametro "last_id")
phonePass - contrasena de la cuenta personal del proveedor del servicio. Puede estar vacio.

{
"status": 200,
"data": {
"code": "753455",
"fullSms": "753455",
"phone": "79969817867",
"receivedDate": "2023-02-23T13:18:57.373Z",
"sender": "",
"id": "377253343",
"phonePass": ""
}
}

Tambien puedes recibir un json con "status" 400; no es un error, sino una respuesta normal del sistema cuando el SMS aun no ha llegado.
Para continuar, repite la solicitud del codigo despues de 5 segundos.
Debe repetirse hasta recibir un SMS o hasta que aparezca un error indicando que el tiempo de vida del pedido expiro (error 500):

{
"status": 400,
"data": {
"msg": "The SMS has not been found yet",
"advice": "The SMS has probably not been received yet. Please try the request again in 10 seconds"
}
}

Codigos de error (status):
500 - el tiempo de vida del pedido ha expirado
502 - error interno, inténtalo de nuevo
504 - fondos insuficientes
505 - pedido no encontrado en el sistema
506 - el parámetro order_id no está especificado
401 - API KEY del usuario no especificada
404 - parámetro del método incorrecto

Recuperar el codigo

En nuestro proyecto no pagas por cada codigo, sino por una especie de alquiler temporal de un numero de telefono para un servicio concreto. En la practica tienes 15 minutos durante los cuales puedes recibir todos los SMS que lleguen al numero emitido para el servicio pedido.
Para que sirve esta funcion? Por ejemplo, registras una Qiwi Wallet y necesitas recibir un SMS para desactivar la funcion de seguridad en Qiwi. Para ello recibes el primer SMS, registras la wallet, desactivas la funcion de seguridad en Qiwi, envias la solicitud wrongcode y te damos el segundo SMS de Qiwi totalmente gratis. No hay limite de SMS adicionales dentro del pedido.
ATENCION!
Solo puedes recibir codigos adicionales durante la vida del pedido, es decir, dentro de los 15 minutos desde que recibiste el numero.

Solicitud GET o POST a la url:

https://get-sms.com/api/v1/?method=wrongcode&order_id=377253343&userkey=testapikey&last_id=377253343

Parametros:
method = wrongcode
order_id = 377253343 Numero de pedido obtenido de la solicitud del numero. Valor obligatorio.
userkey = YOUR_APIKEY
last_id = 377253343 Identificador del ultimo SMS recibido mediante getcode o la solicitud wrongcode anterior. Casi siempre coincide con order_id, pero puede ser distinto; ten cuidado. Valor obligatorio.

{
"status": 200,
"data": {
"code": "753455",
"fullSms": "753455",
"phone": "79969817867",
"receivedDate": "2023-02-23T13:18:57.373Z",
"sender": "",
"id": "377253343",
"phonePass": ""
}
}

{
"status": 400,
"data": {
"msg": "The SMS has not been found yet",
"advice": "The SMS has probably not been received yet. Please try the request again in 10 seconds"
}
}

Codigos de error (status):
500 - el tiempo de vida del pedido ha expirado
501 - el parámetro method es incorrecto
502 - error interno, repite la solicitud
504 - aún no has recibido el primer SMS desde el método getcode.
505 - pedido no encontrado en el sistema
506 - el parámetro order_id no está especificado
401 - API KEY del usuario no especificada
404 - parámetro del método incorrecto

Cancelar un pedido de numero

Si recibiste un numero de telefono pero quieres cancelar el pedido, debes realizar la cancelacion usando este metodo refusenumber.

Solicitud GET o POST a la url:

https://get-sms.com/api/v1/?method=refusenumber&order_id=377253343&userkey=testapikey

Parametros:
method = refusenumber
order_id = 377253343 Numero de pedido obtenido de la solicitud del numero. Valor obligatorio.
userkey = YOUR_APIKEY

Respuesta:
Si la consulta es correcta, se obtendra un json con la clave "status" igual a 200:

{
"status": 200,
"data": {
"msg": "The phone number order has been canceled"
}
}

Si recibes otro mensaje, consulta los codigos de error siguientes.

Codigos de error (status):
500 - el tiempo de vida del pedido ha expirado
502 - error interno, inténtalo de nuevo
506 - el parámetro order_id no está especificado
401 - API KEY del usuario no especificada
404 - parámetro del método incorrecto

Banear numero de telefono

Si durante el registro de la cuenta resulta que el numero recibido no es adecuado, se recomienda usar este metodo bannumber para banear el numero.

Solicitud GET o POST a la url:

https://get-sms.com/api/v1/?method=bannumber&order_id=377253343&userkey=testapikey

Parametros:
method = bannumber
order_id = 377253343 Numero de pedido obtenido de la solicitud del numero. Valor obligatorio.
userkey = YOUR_APIKEY

Respuesta:
Si la consulta es correcta, se obtendra un json con la clave "status" igual a 200:

{
"status": 200,
"data": {
"msg": "The phone number is banned"
}
}

Obtener todos los valores de paises y servicios disponibles

Nuestro nuevo metodo permite recuperar valores de todos los paises y todos los servicios disponibles en cada pais.
Tambien permite indicar un servicio concreto y obtener la cantidad y los precios de todos los paises para ese servicio.

Solicitud GET o POST a la url:

https://get-sms.com/api/v1/?method=getallcount&service=tg&userkey=testapikey

Parametros:
method = getallcount
service = tg Parametro opcional. Si no se indica, el metodo devolvera todos los paises y todos los servicios
userkey = YOUR_APIKEY

Respuesta:
Si la solicitud es correcta, se obtendra un json sin el parametro service:

{
"kazakhstan": [
  {
   "vk": {
    "name": "VK",
    "price": "62.3",
    "count_all": "3712"
   },
   "wa": {
    "name": "Whatsapp",
    "price": "195",
    "count_all": "3740"
   },
   "vi": {
    "name": "Viber",
    "price": "6.55",
    "count_all": "3876"
   },
   "tg": {
    "name": "Telegram",
    "price": "209.49",
    "count_all": "3861"
   },
"ask": {
    "name": "SVOE",
    "price": "8.98",
    "count_all": "3525"
   }
  }
],
"england": [
  {
   "vk": {
    "name": "VK",
    "price": "2.28",
    "count_all": "3909"
   },
   "ok": {
    "name": "Ok.ru",
    "price": "38.2",
    "count_all": "4026"
   },
"atp": {
    "name": "Vonage",
    "price": "2.13",
    "count_all": "3979"
   }
  }
],
...
}

O:
Si la solicitud es correcta, se obtendra un json con el parametro service:

{
"kazakhstan": {
"price": "214.15",
"count_all": "4036"
},
"england": {
"price": "98.67",
"count_all": "3654"
},
"canada": {
"price": "28.57",
"count_all": "3970"
},
"germany": {
"price": "295.73",
"count_all": "1499"
},
"ssha": {
"price": "41.03",
"count_all": "4459"
},
"brazil": {
"price": "178.28",
"count_all": "4157"
},
...
}

Si recibes otro mensaje, consulta los codigos de error siguientes.

Codigos de error (status):
502 - error interno, intenta enviar la solicitud de nuevo
401 - API KEY del usuario no especificada
404 - parámetro del método configurado incorrectamente

API compatible con otros servicios de activacion

Si decides trabajar en compatibilidad con otro servicio de activacion y no reescribir tu software, puedes usar nuestra API compatible. Pero no recomendamos hacerlo, porque no se actualiza ni se mantiene correctamente.
Lo primero que debes hacer para empezar a usar la API compatible es editar el archivo hosts en Windows, que se encuentra en esta direccion
C:\Windows\System32\drivers\etc\
y agregar la siguiente linea:
5.253.63.28 domain.com (el nombre de dominio de otro servicio de activacion)

Si no quieres modificar el archivo hosts, cambia en tu software el dominio del otro servicio de activacion por get-sms.com. La direccion de tus solicitudes debe tener la siguiente forma:
https://get-sms.com/stubs/handler_api.php
Puedes enviar todas las solicitudes por POST o GET.
Ten en cuenta que aun no hay reenvio de llamadas y probablemente no lo habra en esta version de la API.
Por lo demas, nuestra API compatible es identica, por eso copiamos las instrucciones para no multiplicar informacion ni confundir a los usuarios.

Solicitud del numero de numeros disponibles (getNumbersStatus)

Solicitud GET o POST a la url:

https://get-sms.com/stubs/handler_api.php?action=getNumbersStatus&api_key=testapikey&country=2

Parametros:
action = getNumbersStatus
api_key = YOUR_APIKEY
country = 2 Pais. Parametro opcional. El valor por defecto es 2 (Kazakhstan). La lista completa de valores de pais se puede encontrar en la "Lista de paises" seccion

Respuesta:
Si la consulta es correcta, recibiras un json de este tipo:

{
"vk_0": 28,
"ok_0": 4,
"wa_0": 9,
"vi_0": 19,
"tg_0": 30,
"wb_0": 21,
"go_0": 30,
"av_0": 8,
"av_0": 23,
"fb_0": 24
}

Solicitud de saldo (getBalance)

Solicitud GET o POST a la url:

https://get-sms.com/stubs/handler_api.php?action=getBalance&api_key=testapikey

Parametros:
action = getBalance
api_key = YOUR_APIKEY

Respuesta:
Si la consulta es correcta, recibiras TEXTO de este tipo:

ACCESS_BALANCE:100 // donde 100 es tu saldo actual en USD

Errores posibles:
BAD_KEY - Invalid API key
ERROR_SQL - SQL server error

Pedido de numero de telefono (getNumber)

Solicitud GET o POST a la url:

https://get-sms.com/stubs/handler_api.php?action=getNumber&service=vk&country=2&api_key=testapikey

Parametros:
action = getNumber
service = vk Servicio. Parametro obligatorio. La lista completa de valores de servicio se puede encontrar en la "Lista de servicios" seccion.
maxPrice = 25 Optional. The maximum price in your account currency you agree to pay for the number. Without it the number is sold only at the lowest available price; with it, when no numbers are available at the lowest price, more expensive offers are tried automatically up to maxPrice. You are charged the actual price of the sold number, never more than maxPrice. Available price levels: getPrices with tiers=1.
country = 2 Pais. Parametro opcional. El valor por defecto es 2 (Kazakhstan). La lista completa de valores de pais se puede encontrar en la "Lista de paises" seccion
api_key = YOUR_APIKEY

Respuesta:
Si la consulta es correcta, recibiras TEXTO de este tipo, donde $id es el id de transaccion y $number es el numero de telefono:

ACCESS_NUMBER:$id:$number

Otras respuestas:
NO_NUMBERS - no hay numeros disponibles
NO_BALANCE - sin saldo
WRONG_MAX_PRICE:$minPrice - maxPrice is lower than the minimum available price (the minimum available price is returned after the colon)

Errores posibles:
BAD_ACTION - invalid action
BAD_SERVICE - invalid service name
WRONG_SERVICE - The service is not in the system
BAD_KEY - Invalid API key
ERROR_SQL - SQL server error
YOU_TEMPORARY_BANNED - You are banned until the next day

Cambiar estado de activacion (setStatus)

Solicitud GET o POST a la url:

https://get-sms.com/stubs/handler_api.php?action=setStatus&status=1&id=1234567&api_key=testapikey

Parametros:
action = setStatus
status = STATUS CODE Los codigos de estado posibles se indican abajo
id = OPERATION ID ID de pedido recibido de la solicitud getNumber
api_key = YOUR_APIKEY

Estados posibles:
1 notificar que el numero esta listo (SMS enviado al numero)
3 solicitar otro codigo (gratis)
6 completar activacion Si el estado era 'codigo recibido', marcar como correcto y completar. Si era 'preparando', eliminarlo y marcar como error. Si era 'esperando reintento', cambiar la activacion a 'esperando SMS'.
8 informar que el numero se uso y cancelar la activacion.

Respuesta:
Si la solicitud es correcta, recibiras TEXTO segun el estado:

ACCESS_READY - the readiness of the number has been confirmed
ACCESS_RETRY_GET - waiting for a new SMS
ACCESS_ACTIVATION - service successfully activated
ACCESS_CANCEL - activacion cancelada

Errores posibles:
BAD_ACTION - invalid action
NO_ACTIVATION - activation id does not exist
BAD_STATUS - Incorrect status
BAD_KEY - Invalid API key
ERROR_SQL - SQL server error

Obtener estado de activacion (getStatus)

Solicitud GET o POST a la url:

https://get-sms.com/stubs/handler_api.php?action=getStatus&id=1234567&api_key=testapikey

Parametros:
action = getStatus
id = OPERATION ID ID de pedido recibido de la solicitud getNumber
api_key = YOUR_APIKEY

Respuesta:
Si la solicitud es correcta, recibiras TEXTO segun el estado:

STATUS_WAIT_CODE - esperando SMS
STATUS_WAIT_RETRY:'The previous code that did not work' - esperando aclaracion adicional sobre el codigo
STATUS_WAIT_RESEND - esperando que el SMS se reenvie (el software debe pulsar reenviar SMS y cambiar el estado a 6)
STATUS_CANCEL - activacion cancelada
STATUS_OK: 'activation code' - codigo recibido

Errores posibles:
BAD_ACTION - invalid action
NO_ACTIVATION - activation id does not exist
NO_BALANCE - insufficient balance
BAD_KEY - Invalid API key
ERROR_SQL - SQL server error

Obtener todos los precios de servicios (getPrices)

Solicitud GET o POST a la url:

https://get-sms.com/stubs/handler_api.php?action=getPrices&api_key=testapikey&service=SERVICE&country=2

Parametros:
action = getPrices
service = vk Servicio. Parametro opcional. La lista completa de valores de servicio se puede encontrar en la "Lista de servicios" seccion.
api_key = YOUR_APIKEY
tiers = 1 Optional. With tiers=1 the response contains all available price levels for each service (several "price": count pairs sorted by price) instead of a single minimum price. Use these prices as maxPrice in getNumber.
country = 2 Pais. Parametro obligatorio. El valor por defecto es 2 (Kazakhstan). La lista completa de valores de pais se puede encontrar en la "Lista de paises" seccion

Respuesta:
Si la consulta es correcta, recibiras un json de este tipo:

{
"0": {
"vk": {
"25": 36
},
"lb": {
"25": 169
},
"wa": {
"51": 178
},
"vi": {
"2.96": 0
},
"tg": {
"38.8": 0
},
"wb": {
"6.56": 3580
},
"go": {
"7.87": 4433
},
"av": {
"6.69": 3595
},
"fb": {
"3.94": 3932
},
"qw": {
"20": 3759
}
}
}

La jerarquia tiene la siguiente forma - { "Pais": { "Servicio": { "Precio": { "Cantidad"}}}

tiers=1 — response example (all available price levels per service):

{
"2": {
"tg": {
"38.8": 120,
"45.5": 340,
"52": 1210
},
"vk": {
"25": 36
}
}
}

API de alquiler de numeros de telefono a largo plazo

Esta seccion describe como trabajar con la API para alquilar un numero de telefono. La API te permite integrar tus soluciones de software con nuestro servicio.
Si tienes preguntas, siempre puedes contactar con soporte.

El servidor API acepta solicitudes POST y GET
Las solicitudes se envian a la siguiente direccion - https://get-sms.com/api/v2/rent/rent_number.php

Obtener cantidad de numeros disponibles, servicios y precios de alquiler

Solicitud GET o POST a la url:

https://get-sms.com/api/v2/rent/rent_number.php?method=getdatacountry&country=KZ

Parametros:
method = getdatacountry
country = KZ Pais. Parametro obligatorio. La lista completa de valores de pais se puede obtener de la solicitud "solicitud para recuperar todos los paises"

Respuesta:
Si la solicitud es correcta, se devolvera una respuesta JSON con la clave "status" igual a 200.
La clave "data" contendra un objeto con servicios, precios, cantidad de numeros disponibles y operadores:
1xbet (ejemplo) - objeto con clave por codigo de servicio que contiene la cantidad de numeros disponibles para alquiler y los precios de alquiler para un periodo concreto
qty - cantidad de numeros disponibles
price_day - precio por 1 dia de alquiler del numero
operators - operadores disponibles

{
"status": 200,
"data": {
"country": {
"code": "KZ",
"name": "Kazakhstan",
"icon": "/uploads/country_img/Kazakhstan.png",
"available_numbers": 6714
  },
  "operators": [
{
"id": "49",
"name": "Aktiv_Kazakhstan",
"codename": "Aktiv_Kazakhstan"
}
  ],
  "services": [
{
"id": 1,
"name": "1xbet",
"img": "/uploads/service_img/1xbet.png",
"price_day": 69.72,
"qty": 57
},
...
]
}
}

Obtener un numero de telefono para alquiler

Despues de crear el alquiler del numero de telefono, no se realiza reembolso, incluso si cambias de decision, rechazas usar el numero o por otros motivos no relacionados con la imposibilidad tecnica de prestar el servicio.

Solicitud GET o POST a la url:

https://get-sms.com/api/v2/rent/rent_number.php?userkey=testapikey&method=createorder&type=week&period=1&services=82,1,4&country=KZ&operator=ANY

Parametros:
method = createorder
userkey = YOUR_APIKEY
type = weekParametro obligatorio. Tipo de periodo: week (semanas) o month (mes).
period = 1 Numero de semanas o meses. Parametro obligatorio. El valor 1 y el tipo week significan que queremos alquilar el numero durante 1 semana.
services = 82,1,4 Servicios (con ID 82, 1 y 4). Parametro obligatorio. La lista completa de valores de servicio se puede encontrar en la "Lista de servicios de alquiler".
country = KZ Country. Required parameter. A full list of possible country values can be obtained from the "Lista de paises de alquiler"
operator = ANY Operador movil. Parametro opcional. La lista de operadores se puede obtener desde la solicitud de lista de paises o lista de servicios

Respuesta:
Si la solicitud es correcta, se devolvera una respuesta JSON con la clave "status" igual a 200.
La clave "data" contendra un objeto con la clave "order_id", que es el numero de pedido para trabajar despues con el numero, y la clave "phone", que contiene el numero para recibir SMS con codigos de verificacion.
El numero se emite en formato internacional con codigo de pais y sin el signo +. Tenlo en cuenta.

Para mayor comodidad, los intervalos de tiempo se proporcionan como UNIX timestamps y en formato estandar de 24 horas:
end_time_timestamp - UNIX timestamp hasta el fin del alquiler
end_time - fecha y hora en que termina el alquiler
start_timestamp - fecha y hora en que empieza el alquiler como UNIX timestamp

{
"status": 200,
"data": {
"order_id": 123,
"country_code": "+7",
"phone": "79991234567",
"end_time_timestamp": 1771234567,
"end_time": "18.02.2026 14:30",
"start_timestamp": 1768642567,
"orders_count": 1,
"order_ids": [123]
}
}

Codigos de error (status):
401 - error en el parámetro userkey
402 - error en el parámetro country
404 - país no encontrado
502 - error en el parámetro services
504 - tipo de periodo incorrecto
506 - periodo incorrecto para el tipo week/month
504 - no se pudo obtener respuesta del servidor
503 - error interno del servidor. Envía la solicitud más tarde
507 - mantenimiento técnico en curso

Recuperar todos los SMS del numero alquilado

Solicitud GET o POST a la url:

https://get-sms.com/api/v2/rent/rent_number.php?method=getsms&userkey=testapikey&rentid=888

Parametros:
method = getsms
userkey = YOUR_APIKEY
rentid= 888 Parametro obligatorio. ID de pedido recibido de la solicitud para obtener un numero de alquiler. Este parametro tambien se puede encontrar en la solicitud para recuperar todos los pedidos activos.

Respuesta:
Si la solicitud es correcta, se devolvera una respuesta JSON con la clave "status" igual a 200.
La clave "data" contendra un objeto con la clave "sms_list", que contiene todos los SMS recibidos en este numero.

{
"status": 200,
"data": {
"msg": "List of all SMS messages",
"sms_list": [
{
"date": "2026-05-21 14:30:00",
"text": "Your code: 123456",
"timestamp": 1779363000
},
{
"date": "2026-05-21 14:35:00",
"text": "Your code: 45345345",
"timestamp": 1779363500
}
]
}
}

Tambien puedes recibir una respuesta JSON con "status" 200. No es un error; es una respuesta normal del sistema cuando el alquiler expiro.

{
"status": 200,
"data": {
"msg": "Rent is not active, SMS refresh was skipped",
"can_reload_sms": false,
"status_rent": 0,
"sms_list": []
}
}

Codigos de error (status):
401 - API KEY del usuario no especificada
404 - pedido de alquiler no encontrado
504 - no se pudo obtener respuesta del servidor
502 - Rental ID no especificado

Extender el pedido de alquiler

Solicitud GET o POST a la url:

https://get-sms.com/api/v2/rent/rent_number.php?userkey=testapikey&method=prolong&type=week&period=1&rentid=888

Parametros:
method = prolong
userkey = YOUR_APIKEY
type = week Required parameter. Period type: week (weeks) or month (month).
period = 1 Numero de semanas o meses. Parametro obligatorio. El valor 1 y el tipo week significan que queremos extender el numero durante 1 semana.
rentid= 888 Parametro obligatorio. ID de pedido recibido de la solicitud para obtener un numero de alquiler. Este parametro tambien se puede encontrar en la solicitud para recuperar todos los pedidos activos.

Respuesta:
Si la solicitud es correcta, se devolvera una respuesta JSON con la clave "status" igual a 200. Esto significa que la extension del numero se completo correctamente.

{
"status": 200,
"data": {
"msg": "Rental successfully extended",
"order_id": 888,
"days": 7,
"price": 350,
"rent_at": 1779967800,
"rent_at_formatted": "2026-05-28 14:30:00"
}
}

Codigos de error (status):
401 - error en el parámetro userkey
504 - tipo de periodo incorrecto
506 - periodo incorrecto para el tipo week/month
504 - no se pudo obtener respuesta del servidor
503 - error interno del servidor. Envía la solicitud más tarde
507 - mantenimiento técnico en curso

Recuperar todos los paises para alquiler

Solicitud GET o POST a la url:

https://get-sms.com/api/v2/rent/rent_number.php?method=countries

Parametros:
method = countries

Respuesta:
Si la solicitud es correcta, se devolvera una respuesta JSON con la clave "status" igual a 200, con una lista de todos los paises disponibles y sus operadores moviles

{
"status": 200,
"data": {
"countries": [
{
"code": "AT",
"name": "Austria",
"available_numbers": 93,
"operators": [
{
"id": 30,
"name": "Tele2",
"codename": "Tele2_AT",
"available_numbers": 93
}
]
   },
   {
"code": "AR",
"name": "Argentina",
"available_numbers": 3969,
"operators": [
{
"id": 25,
"name": "Claro",
"codename": "Claro_AR",
"available_numbers": 3969
}
]
},
   {
"code": "BE",
"name": "Belgium",
"available_numbers": 2363,
"operators": [
{
"id": 69,
"name": "Lycamobile",
"codename": "Lycamobile_BE",
"available_numbers": 2363
}
]
}
],
  "count": 33
}
}

Recuperar todos los pedidos de alquiler

Solicitud GET o POST a la url:

https://get-sms.com/api/v2/rent/rent_number.php?userkey=testapikey&method=allorders

Parametros:
method = allorders
userkey = YOUR_APIKEY

Respuesta:
Si la solicitud es correcta, se devolvera una respuesta JSON con un array de todos los numeros de alquiler pedidos, incluidos los numeros cuyo alquiler fue cancelado o completado.
Significado de la clave status:
status = 0 El periodo de alquiler del numero expiro
status = 1 El alquiler esta activo

{
"status": 200,
"data": {
"msg": "List of all orders",
"orders": [
{
"id": 123,
"phone": "77991234567",
"number_phone": "77991234567",
"status_rent": 1,
"status_label": "Active",
"can_reload_sms": true,
"service_name": "Telegram",
"country_code": "KZ",
"country_name": "Kazakhstan",
"code_country_phone": "+7",
"operator": "Aktiv_KZ",
"price_day": 50,
"total_price": 350,
"period_price": 7,
"rent_from": 1779363000,
"rent_at": 1779967800,
"date_from": "2026-05-21 14:30:00",
"date_at": "2026-05-28 14:30:00",
"userkey": "USERKEY"
}
],
"count": 1
}
}

Si no hay numeros alquilados, recibiras un array vacio:

{
"status": 200,
"data": {
"msg": "List of all orders",
"orders": [],
"count": 0
}
}

Lista de paises

Valor	Nombre	Valor de API compatible
kazakhstan	Kazakhstan	2
england	England	16
canada	Canada	36
germany	Germany	43
usavirt	USA (Virtual)	12
brazil	Brazil	73
estonia	Estonia	34
france	France	78
indonesia	Indonesia	6
kyrgyzstan	Kyrgyzstan	11
laos	Laos	25
lithuania	Lithuania	44
netherlands	Netherlands	48
poland	Poland	15
romania	Romania	32
sweden	Sweden	46
indiia	India	22
malaiziia	Malaysia	7
vetnam	Vietnam	10
filippiny	Philippines	4
turtsiia	Turkey	62
moldova	Moldova	85
uzbekistan	Uzbekistan	40
gruziia	Georgia	128
irlandiia	Ireland	23
portugaliia	Portugal	117
ispaniia	Spain	56
chekhiia	Czech Republic	63
bangladesh	Bangladesh	60
ssha	USA	187
ukr	Ukraine	1
gonkong	Hong Kong	14
tailand	Thailand	52
meksika	Mexico	54
latviia	Latvia	49
pakistan	Pakistan	66
gretsiia	Greece	129
nikaragua	Nicaragua	90
argentina	Argentina	39
gaiti	Haiti	26
mongoliia	Mongolia	72
izrail	Israel	13
egipet	Egypt	21
gvatemala	Guatemala	94
liviia	Libya	102
iran	Iran	57
iemen	Yemen	30
tadzhikistan	Tajikistan	143
kitai	China	3
shrilanka	Sri Lanka	64
siriia	Syria	110
livan	Lebanon	153
boliviia	Bolivia	92
serbiia	Serbia	29
kolumbiia	Colombia	33
avstriia	Austria	50
alzhir	Algeria	58
peru	Peru	65
gonduras	Honduras	88
marokko	Morocco	37
venesuela	Venezuela	70
nigeriia	Nigeria	19
iamaika	Jamaica	103
salvador	Salvador	101
botsvana	Botswana	123
paragvai	Paraguay	87
nepal	Nepal	81
uganda	Uganda	75
irak	Iraq	47
iordaniia	Jordan	116
mianma	Myanmar	5
demkongo	Dem.Congo	18
keniia	Kenya	8
kambodzha	Cambodia	24
belarus	Belarus	51
kotdivuar	Ivory Coast	27
saudaraviia	Saud. Arabia	53
oae	UAE	95
khorvatiia	Croatia	45
papuanovaiagvineia	Papua New Guinea	79
tanzaniia	Tanzania	9
gvineia	Guinea	68
mali	Mali	69
kamerun	Cameroon	41
mavritaniia	Mauritania	114
serraleone	Sierra Leone	115
burkinafaso	Burkina Faso	152
daniia	Denmark	172
tunis	Tunisia	89
dominikanskaiarespublika	Dominican Republic	109
iuzhnaiaafrika	South Africa	31
ekvador	Ecuador	105
liberiia	Liberia	135
senegal	Senegal	61
afganistan	Afghanistan	74
novaiazelandiia	New Zealand	67
chad	Chad	42
angola	Angola	76
gana	Ghana	38
iuzhnaiakoreia	South Korea	190
sudan	Sudan	98
taivan	Taiwan	55
zimbabve	Zimbabwe	96
turkmenistan	Turkmenistan	161
reiunon	Reunion	146
kipr	Cyprus	77
gaiana	Guyana	131
maldivy	Maldives	159
mozambik	Mozambique	80
gambiia	Gambia	28
trinidaditobago	Trinidad and Tobago	104
gabon	Gabon	154
brunei	Brunei	121
butan	Bhutan	158
surinam	Suriname	142
armeniia	Armenia	148
benin	Benin	120
mavrikii	Mauritius	157
fidzhi	Fiji	189
kongo	Congo	150
dominika	Dominica	126
bermudy	Bermuda	195
aruba	Aruba	179
chili	Chili	151
finliandiia	Finland	163
italiia	Italy	86
bolgariia	Bulgaria	83
vengriia	Hungary	84
sloveniia	Slovenia	59
khorvatiia	Croatia	45
norvegiia	Norway	174

Lista de servicios

Valor	Nombre
ai	CELEBe
do	Leboncoin
dh	EBay
sk	Skroutz
lq	Potato
mh	Ashan
wv	AIS
ia	Socios
bf	Keybase
mm	Microsoft
qd	Taobao
at	Perfluence
qf	RedBook
dp	ProtonMail
mi	Zupee
yb	Quartet+
wa	Whatsapp
uz	OffGamers
ou	Gabi
he	Mewt
jj	Aitu
ez	GoerliFaucet
ts	PayPal
ta	Wink
qt	MoneyControl
ef	Nextdoor
ad	Iti
cg	Gemgala
nu	Stripe
rf	Akudo
kj	YAPPY
ul	Getir
nv	Naver
fw	99acres
ud	Disney Hotstar
lw	MrGreen
io	ZdravCity
oy	CashFly
qm	RosaKhutor
mn	RRSA
dt	Delivery Club
lt	BitClout
ui	RuTube
qw	Qiwi
fj	Potato Chat
tx	Bolt
kc	Vinted
xd	Tokopedia
pp	Huya
qj	Whoosh
qh	Oriflame
jt	TurkiyePetrolleri
ok	Ok.ru
wk	Mobile01
bn	Alfagift
wh	TanTan
vm	OkCupid
ri	BillMill
bs	TradeUP
tw	Twitter
ey	Miloan
je	Nanovest
hr	JKF
kn	Verse
yf	Citymobil
aj	OneAset
bx	Dosi
ca	SuperS
gr	Astropay
rv	Kotak811
bp	GoFundMe
ni	Gojek
fy	Mylove
dk	Pairs
bk	G2G
bb	LazyPay
vo	Brand20ua
bh	Uteka
gz	LYKA
ww	BIP
ur	MyDailyCash
cx	Icrypex
sh	VkusVill
gv	Humta
ve	Dream11
kp	HQ Trivia
uf	Eneba
aa	Probo
tk	MVideo
iq	Icq
ej	MrQ
ss	Hezzl
sf	SneakersnStuff
ce	Mosru
dc	YikYak
sl	SberApteka
dl	Lazada
uo	CafeBazaar
uh	Yubo
pl	Perekrestok
dg	Mercari
cb	Bazos
pu	Justdating
gh	GyFTR
ev	Picpay
qg	MoneyPay
bw	Signal
cc	Quipp
jf	Likee
eq	Qoo10
dd	CloudChat
jc	IVI
er	Kwork
ip	Burger King
bu	MonobankIndia
nq	Trip
qi	23red
eg	ContactSys
cp	Uklon
sg	OZON
xr	Tango
uk	Airbnb
ko	AdaKami
nf	Netflix
vy	Meta
dy	Zomato
ha	My11Circle
tg	Telegram
dq	IceCasino
rs	Lotus
bc	GCash
ne	Coindcx
mr	Fastmail
we	DrugVokrug
ry	McDonalds
qa	MyFishka
pm	AOL
la	Ssoidnet
ak	Douyu
go	Google,youtube,Gmail
oi	Tinder
dn	Paxful
xl	Wmaraci
vz	Hinge
rd	Lenta
wb	WeChat
ew	Nike
gm	Mocospace
wj	1xbet
xe	GalaxyChat
sn	OLX
ae	MyGLO
ch	Pocket52
py	Monese
hn	1688
qy	Zhihu
ck	BeReal
kw	Foody
ml	ApostaGanha
ci	RedBus
wc	Craigslist
pd	IFood
be	SberMegaMarket
xy	Depop
cf	Irancell
wp	163COM
rx	Sheerid
su	LOCO
ho	Cathay
af	GalaxyWin
bq	Adani
oq	Vlife
ru	HOP
om	Corona
sb	Lamoda
ig	Instagram
uj	ChampionCasino
mu	MyMusicTaste
cq	Mercado
ti	Cryptocom
uu	Wildberries
ub	Uber
ln	Grofers
me	Line msg
of	Urent
fz	KFC
un	Humblebundle
ug	Fiqsy
kr	Eyecon
vn	Yaay
qe	GG
ds	Discord
gg	PagSmile
uw	Kirana
vs	WinzoGame
gt	Gett
uy	Meliuz
hq	Magicbricks
im	Imo
bv	Metro
po	Premium.one
jg	Grab
es	IQIYI
bo	Wise
kb	Kufarby
wq	Leboncoin1
jh	PingPong
tt	Ziglu
rr	Wolt
ih	TeenPattiStarpro
od	FWDMAX
iv	Inboxlv
xh	OVO
ra	KeyPay
bz	Blizzard
rc	Skype
pt	Bitaqaty
gu	Fora
ma	Mail.ru
ji	Monobank
op	MIRATORG
hk	4Fun
gp	Ticketmaster
up	Magnolia
dr	OpenAI
bd	X5ID
gl	GlobalTel
gx	Hepsiburadacom
ay	Ruten
sr	Starbucks
pa	Gamekit
ct	KuhnyaNaRayone
ht	Bitso
ft	Bookmakers
ka	Shopee
mx	SoulApp
wt	IZI
sw	NCsoft
ep	Temu
mc	Michat
qr	MEGA
ee	Twilio
le	E bike Gewinnspiel
ec	RummyCulture
qu	Agroinform
oh	MapleSEA
fa	XadrezFeliz
cm	Prom
bt	Alfa
ya	Yandex
ot	Any other
cj	Dotz
hh	Uplay
gc	TradingView
sm	YoWin
ki	99app
tu	Lyft
de	Karusel
pq	CDkeys
fm	Touchance
lr	Okta
ly	Olacabs
va	SportGully
df	Happn
kf	Weibo
vc	Banqi
fk	BLIBLI
xn	Familia
th	WestStein
fs	Şikayet var
rz	EasyPay
cn	Fiverr
dx	Powerkredite
pg	NRJ Music Awards
bg	MIXMART
mj	Zalo
xw	Taki
ua	BlaBlaCar
pf	Pof.com
an	Adidas
mk	LongHu
lh	24betting
hg	Switips
sq	KuCoinPlay
lx	DewuPoison
gf	GoogleVoice
iy	FoodHub
nz	Foodpanda
ah	EscapeFromTarkov
nw	Ximalaya
sj	HandyPick
et	Clubhouse
tl	Truecaller
md	Banks
co	Rediffmail
ga	Roposo
oc	DealShare
og	Okko
rh	Ace2Three
rl	InDriver
dj	LUKOIL-AZS
pr	Trendyol
bj	Vita Express
rk	Fotka
ao	UU163
nr	Tosla
ph	SnappFood
ar	Wondermart
ij	Revolut
qc	Primaries 2020
gd	Surveytime
ky	SpatenOktoberfest
sp	HappyFresh
xj	SberMarket
ac	DoorDash
ba	Expressmoney
kz	NimoTV
np	Siply
vf	Q12 Trivia
tf	Noon
iz	Global24
jz	Kaya
yd	米画师Mihuashi
cl	UWIN
fx	PGbonus
jr	Scooter
px	Nifty
nl	Myntra
tn	LinkedIN
dw	Divar
ke	Eldorado
ku	RoyalWin
el	Bisu
bm	MarketGuru
nn	Giftcloud
lp	Algida
eo	Sizeer
cw	PaddyPower
gw	CallApp
wo	Parkplus
si	Cita Previa
xt	Flipkart
wx	Apple
qz	Faceit
di	Loanflix
kx	Vivo
nb	Faithful
xi	InFund
pw	SellMonitor
fb	Facebook
ex	Linode
st	Ashan
mt	Steam
av	Avito
db	Ezbuy
wn	GameArena
sa	AGIBANK
re	Coinbase
no	Virgo
ls	Careem
ql	CMTcuzdan
tm	Akulaku
rb	Tick
ei	Taksheel
hc	MOMO
qk	Bit
gs	SamsungShop
lf	TikTok/Douyin
vd	Betfair
so	RummyWealth
wl	YouGotaGift
yx	JTExpress
vj	Stormgain
sv	Dostavista
ob	Onlinerby
rp	Hamrahaval
tc	Rambler
vx	HeyBox
ab	Alibaba
eh	Telegram 2.0
jm	Mzadqatar
fo	MobiKwik
az	CityBase
ny	Pyro Music
xu	RecargaPay
yk	SportMaster
zw	Quack
lv	Megogo
fh	Lalamove
ja	Weverse
xq	MPL
lc	Subito
ea	JamesDelivery
qn	Blued
ib	Immowelt
wg	Skout
ff	AVON
jx	Swiggy
au	Haraj
uv	BinBin
eb	Voltz
ju	Indomaret
kt	KakaoTalk
km	Rozetka
yg	CourseHero
cd	SpotHit
xk	DiDi
qo	Moneylion
sd	Dodopizza
fe	CliQQ
ed	Gamer
bi	勇仕网络Ys4fun
yz	Around
xf	LightChat
tj	DbrUA
mf	Weidian
rg	Porbet
xv	Wish
mb	Yahoo
mg	Magnet
gi	Hotline
hm	Globus
ol	KazanExpress
xb	RummyOla
vk	Vkontakte
hw	Alipay/Alibaba
oz	Poshmark
tq	Swvl
fc	PharmEasy
ue	Onet
aq	Glovo
mq	GMNG
my	CAIXA
vw	CoinField
dm	Iwplay
fg	IndianOil
xs	GroupMe
hx	AliExpress
yj	EWallet
eu	LiveScore
cy	RSA
us	IRCTC
br	Vkusno i Tochka
jb	Wing Money
fl	RummyLoot
fr	Dana
aw	Taikang
zh	Zoho
zj	ROBINHOOD
zi	LoveLocal
yp	Payzapp
zd	Zilch
yo	Amasia
zs	Bilibili
zm	OfferUp
yw	Grindr
yy	Venmo
zl	Airtel
yl	Yalla
zn	Biedronka
fv	Vidio
fu	Snapchat
cr	TenChat
hi	JungleeRummy
nk	Gittigidiyor
vv	Seosprint
dv	NoBroker
hl	Band
ll	888casino
hb	Twitch
vp	Kwai
td	ChaingeFinance
xz	Paycell
li	Baidu
lj	Santander
xx	Joyride
yq	Foxtrot
mo	Bumble
ge	Paytm
lb	Mailru Group
zq	IndiaPlays
ik	GuruBets
cu	炙热星河
oe	Codashop
kh	Bukalapak
sy	Brahma
vi	Viber
os	Dhani
uc	Tatneft
ym	Yula
rm	Faberlic
cv	WashXpress
pz	Lidl
kl	Kolesa.kz
gj	Carousell
zf	OnTaxi
gb	YouStar
en	Hermes
jl	Hopi
hy	Ininal
ax	CrefisaMais
iu	Bykea
fi	Dundle
gk	AptekaRU
rt	Hily
cz	Getmega
dz	Dominos Pizza
fd	Mamba
kg	FreeChargeApp
il	IQOS
hz	Drom
xm	Létoile
qq	Tencent QQ
tp	IndiaGold
am	Amazon
qb	Payberry
hu	Ukrnet
em	ZéDelivery
vg	ShellBox
tr	Paysend
cs	AgriDevelop
lk	PurePlatfrom
rj	Kids' World
wf	YandexGo
zu	BigC
jq	Paysafecard
nm	Thisshop
bl	BIGO LIVE
sz	Pivko24
hj	Stoloto
da	MTS CashBack
du	AUBANK
yn	Allegro
zo	Kaggle
zv	Digikala
yu	Xiaomi
yv	IPLwin
zg	Setel
yi	Yemeksepeti
zk	Deliveroo
zt	Budweiser
zr	Papara
zz	Dent
zx	CommunityGaming
zy	Nttgame
ys	ZCity
za	JDcom
call	Receiving a reset call