Saltar al contenido
Logotipo del sitioTextVerification
Desarrolladores

Documentación de la API

Pide números, lee códigos y gestiona alquileres desde tu propio código. La API usa el mismo saldo y los mismos precios que tu panel, en todos los productos.

  • REST y JSON sobre HTTPS
  • Clave de API (Bearer)
  • Callbacks con reintentos
  • 100 solicitudes por minuto
  • Los mismos precios que en tu panel

Primeros pasos

Todo lo que necesitas antes de tu primera solicitud: la dirección, la autenticación, el formato de las respuestas y los errores que puedes encontrar.

URL base

https://textverification.io/api/v1/users

Autenticación

Envía tu clave de API como token Bearer: Authorization: Bearer YOUR_API_KEY. Genera una clave en la configuración de tu cuenta y guárdala en tu servidor: cualquiera que la tenga puede gastar tu saldo.

Solicitudes y respuestas

Envía el cuerpo de las solicitudes en JSON (también se aceptan campos de formulario). Todas las respuestas son JSON con statusCode, success, message y data; los precios van en dólares estadounidenses, como cadenas con dos decimales.

Inicio rápido

Pide un número Pinpoint y lee su código. Todos los demás productos funcionan igual.

cURL
curl -X POST "https://textverification.io/api/v1/users/request-s2-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"serviceId":"1fe58df2"}'
Node.js
const API = "https://textverification.io/api/v1/users";
const headers = {
  Authorization: `Bearer ${process.env.API_KEY}`,
  "Content-Type": "application/json",
};

// 1. Order a number
const order = await fetch(`${API}/request-s2-service`, {
  method: "POST",
  headers,
  body: JSON.stringify({ serviceId: "1fe58df2" }),
}).then((res) => res.json());

// 2. Read the order (or set a callback URL instead of polling)
const { data } = await fetch(
  `${API}/number-details-s2?orderId=${order.data.orderId}`,
  { headers }
).then((res) => res.json());
Python
import os, requests

API = "https://textverification.io/api/v1/users"
headers = {"Authorization": f"Bearer {os.environ['API_KEY']}"}

# 1. Order a number
order = requests.post(f"{API}/request-s2-service",
                      json={"serviceId": "1fe58df2"}, headers=headers).json()

# 2. Read the order (or set a callback URL instead of polling)
details = requests.get(f"{API}/number-details-s2",
                       params={"orderId": order["data"]["orderId"]},
                       headers=headers).json()
print(details["data"]["status"], details["data"]["pin"])

Errores

EstadoDescripción
400La solicitud no es válida o tu saldo no cubre el pedido.
401Falta la clave de API, no es válida o está inactiva.
403No está permitido en este momento, por ejemplo, por demasiados pedidos abiertos o una cuenta restringida.
404El pedido o el servicio no existe o no es tuyo.
409El pedido ya no se puede modificar (ya está completado o cancelado), o su precio acaba de cambiar.
422Una opción no es válida, como un código de área o un periodo de alquiler desconocido.
429Demasiadas solicitudes: reduce el ritmo y vuelve a intentarlo en breve.
503El producto no está disponible en este momento. Vuelve a intentarlo más tarde o usa otro producto.

Usa callbacks en lugar de consultas periódicas: avisan a tu servidor en cuanto llega un código. Si consultas un pedido periódicamente, espera unos segundos entre solicitudes.

Límites de solicitudes

Cada dirección IP puede hacer hasta 100 solicitudes por minuto, y cada clave de API hasta 600 por minuto desde todas las direcciones. Todas las respuestas incluyen las cabeceras RateLimit-Remaining y RateLimit-Reset. Una solicitud que supera el límite recibe un 429 con una cabecera Retry-After que indica cuántos segundos esperar. Con los callbacks te mantienes muy por debajo del límite.

Protege tu integración

  • Guarda tu clave de API en tu servidor: nunca en una app móvil, en código del navegador ni en un repositorio público.
  • Si una clave puede haberse filtrado, genera una nueva en la configuración de tu cuenta. La clave anterior deja de funcionar de inmediato.
  • Las URL de callback deben usar HTTPS. Añade a la ruta un token difícil de adivinar y, antes de actuar, comprueba que cada orderId corresponde a un pedido que hiciste tú.
  • Tu clave gasta tu saldo: consúltalo con el endpoint de saldo y recarga antes de pedir grandes lotes.

Consultar tu saldo

Devuelve el saldo de tu cuenta en dólares estadounidenses.

GET/balance
Ejemplo de solicitud
curl "https://textverification.io/api/v1/users/balance" \
  -H "Authorization: Bearer YOUR_API_KEY"
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": "120.50",
  "message": "Request Successful!",
  "success": true
}

Prime

Números de EE. UU. con elección de estado y solicitudes premium para servicios agotados.

Listar servicios y precios

Muestra los servicios de Prime con tu precio para cada uno, ya con tu descuento aplicado.

GET/server1-pricing
Ejemplo de solicitud
curl "https://textverification.io/api/v1/users/server1-pricing" \
  -H "Authorization: Bearer YOUR_API_KEY"
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": [
    {
      "serviceId": "2264119e",
      "serviceName": "WhatsApp",
      "price": "1.30"
    }
  ],
  "message": "Request Successful!",
  "success": true
}

Consultar el precio de un servicio con opciones

Devuelve tu precio para un servicio con las opciones con las que lo pedirías.

GET/server1-price
ParámetroTipoObligatorioDescripción
serviceIdstringSíEl ID del servicio, de la lista de servicios.
areaCodestringNoUn código de área de EE. UU. de 3 dígitos, como "212", para obtener un número de esa área. Tiene prioridad sobre el estado y puede aumentar el precio.
requestPremiumnumberNoUna puja premium para servicios agotados: el pedido queda pendiente y obtiene un número cuando haya uno disponible.
Ejemplo de solicitud
curl "https://textverification.io/api/v1/users/server1-price?serviceId=2264119e&areaCode=212&requestPremium=20" \
  -H "Authorization: Bearer YOUR_API_KEY"
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": {
    "serviceId": "2264119e",
    "serviceName": "WhatsApp",
    "areaCode": "212",
    "requestPremium": 20,
    "price": "1.56"
  },
  "message": "Request Successful!",
  "success": true
}

Listar estados de EE. UU.

Muestra los estados de EE. UU. que puedes solicitar.

GET/us-states
Ejemplo de solicitud
curl "https://textverification.io/api/v1/users/us-states" \
  -H "Authorization: Bearer YOUR_API_KEY"
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": {
    "CA": "CA",
    "FL": "FL",
    "NY": "NY",
    "TX": "TX"
  },
  "message": "Request Successful!",
  "success": true
}

Pedir un número

Pide un número de Prime para un servicio y lo cobra de tu saldo.

POST/request-s1-service
ParámetroTipoObligatorioDescripción
serviceIdstringSíEl ID del servicio, de la lista de servicios.
statestringNoUn código de estado de EE. UU., como "NY", para obtener un número de ese estado.
areaCodestringNoUn código de área de EE. UU. de 3 dígitos, como "212", para obtener un número de esa área. Tiene prioridad sobre el estado y puede aumentar el precio.
requestPremiumnumberNoUna puja premium para servicios agotados: el pedido queda pendiente y obtiene un número cuando haya uno disponible.

Con una puja premium, el pedido de un servicio agotado queda pendiente; recibirás un callback s1_win_premium_request cuando obtenga un número.

Ejemplo de solicitud
curl -X POST "https://textverification.io/api/v1/users/request-s1-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"serviceId":"2264119e","state":"NY"}'
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": {
    "orderId": "55655059",
    "number": "12125550101",
    "serviceName": "WhatsApp",
    "status": "reserved",
    "state": "NY",
    "areaCode": "",
    "requestPremium": 0,
    "price": "1.30",
    "expiredIn": 900
  },
  "message": "Request Successful!",
  "success": true
}

Consultar un pedido

Devuelve un pedido con su estado y, cuando haya llegado, el código.

GET/number-details-s1
ParámetroTipoObligatorioDescripción
orderIdstringSíEl ID del pedido, tal como se devolvió al hacer el pedido.
Ejemplo de solicitud
curl "https://textverification.io/api/v1/users/number-details-s1?orderId=55655059" \
  -H "Authorization: Bearer YOUR_API_KEY"
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": {
    "orderId": "55655059",
    "number": "12125550101",
    "serviceName": "WhatsApp",
    "country": "United States",
    "state": "NY",
    "areaCode": "",
    "price": "1.30",
    "createdAt": "2026-10-09 12:44:00",
    "status": "completed",
    "message": "Your code is 482910",
    "pin": "482910"
  },
  "message": "Request Successful!",
  "success": true
}

Reutilizar un número

Vuelve a pedir el mismo número para otro código, si el servicio lo permite.

POST/reuse-s1-service
ParámetroTipoObligatorioDescripción
orderIdstringSíEl ID del pedido, tal como se devolvió al hacer el pedido.
Ejemplo de solicitud
curl -X POST "https://textverification.io/api/v1/users/reuse-s1-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"55655059"}'
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": {
    "orderId": "55655059",
    "number": "12125550101",
    "serviceName": "WhatsApp",
    "country": "United States",
    "state": "NY",
    "areaCode": "",
    "price": "1.30",
    "status": "reserved",
    "expiredIn": 600
  },
  "message": "Request Successful!",
  "success": true
}

Cancelar un número

Cancela un número que aún no ha recibido ningún código y reembolsa el importe a tu saldo.

POST/reject-s1-service
ParámetroTipoObligatorioDescripción
orderIdstringSíEl ID del pedido, tal como se devolvió al hacer el pedido.
Ejemplo de solicitud
curl -X POST "https://textverification.io/api/v1/users/reject-s1-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"55655059"}'
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": null,
  "message": "Request Successful!",
  "success": true
}

Pinpoint

Números de EE. UU. con los códigos de área y operadores que elijas, y el código por SMS o, donde se ofrezca, por llamada de voz.

Listar servicios y precios

Muestra los servicios de Pinpoint con tu precio para cada uno, ya con tu descuento aplicado.

GET/server2-pricing
Ejemplo de solicitud
curl "https://textverification.io/api/v1/users/server2-pricing" \
  -H "Authorization: Bearer YOUR_API_KEY"
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": [
    {
      "serviceId": "1fe58df2",
      "serviceName": "google"
    }
  ],
  "message": "Request Successful!",
  "success": true
}

Consultar el precio de un servicio con opciones

Devuelve tu precio para un servicio con las opciones con las que lo pedirías.

GET/server2-price
ParámetroTipoObligatorioDescripción
serviceIdstringSíEl ID del servicio, de la lista de servicios.
areasstringNoCódigos de área entre los que elegir, separados por comas (hasta 10), p. ej., "212,646". Aumentan el precio.
carrierstringNoOperadores entre los que elegir, separados por comas: tmo (T-Mobile), vz (Verizon), att (AT&T). Aumentan el precio.
capabilitystringNo"sms" (predeterminado), o "voice" para recibir el código por llamada donde se ofrezcan llamadas de voz.
Ejemplo de solicitud
curl "https://textverification.io/api/v1/users/server2-price?serviceId=1fe58df2&areas=212%2C646&carrier=vz" \
  -H "Authorization: Bearer YOUR_API_KEY"
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": {
    "serviceName": "google",
    "price": "1.53",
    "capability": "sms",
    "areaCode": true,
    "carrier": true
  },
  "message": "Request Successful!",
  "success": true
}

Listar códigos de área

Muestra los códigos de área de EE. UU. que puedes solicitar, con sus estados.

GET/server2-area-codes
Ejemplo de solicitud
curl "https://textverification.io/api/v1/users/server2-area-codes" \
  -H "Authorization: Bearer YOUR_API_KEY"
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": [
    {
      "areaCode": "212",
      "state": "New York"
    },
    {
      "areaCode": "503",
      "state": "Oregon"
    }
  ],
  "message": "Request Successful!",
  "success": true
}

Pedir un número

Pide un número de Pinpoint para un servicio y lo cobra de tu saldo.

POST/request-s2-service
ParámetroTipoObligatorioDescripción
serviceIdstringSíEl ID del servicio, de la lista de servicios.
areasstringNoCódigos de área entre los que elegir, separados por comas (hasta 10), p. ej., "212,646". Aumentan el precio.
carrierstringNoOperadores entre los que elegir, separados por comas: tmo (T-Mobile), vz (Verizon), att (AT&T). Aumentan el precio.
capabilitystringNo"sms" (predeterminado), o "voice" para recibir el código por llamada donde se ofrezcan llamadas de voz.

Los pedidos de voz (capability "voice") se atienden con el Voice SDK de Twilio y el token del endpoint de token de voz. El pedido se completa cuando llega la llamada, y sus detalles incluyen la llamada.

Ejemplo de solicitud
curl -X POST "https://textverification.io/api/v1/users/request-s2-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"serviceId":"1fe58df2","areas":"212,646","carrier":"vz,att"}'
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": {
    "orderId": "lr_01K7ABC",
    "number": "12125550102",
    "serviceName": "google",
    "status": "reserved",
    "areas": "212,646",
    "carrier": "vz,att",
    "capability": "sms",
    "price": "1.53",
    "expiredIn": 600
  },
  "message": "Request Successful!",
  "success": true
}

Consultar un pedido

Devuelve un pedido con su estado y, cuando haya llegado, el código.

GET/number-details-s2
ParámetroTipoObligatorioDescripción
orderIdstringSíEl ID del pedido, tal como se devolvió al hacer el pedido.
Ejemplo de solicitud
curl "https://textverification.io/api/v1/users/number-details-s2?orderId=lr_01K7ABC" \
  -H "Authorization: Bearer YOUR_API_KEY"
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": {
    "orderId": "lr_01K7ABC",
    "number": "12125550102",
    "serviceName": "google",
    "country": "United States",
    "areas": "212,646",
    "carrier": "vz,att",
    "capability": "sms",
    "price": "1.53",
    "createdAt": "2026-10-09 12:44:00",
    "status": "completed",
    "message": "Your code is 482910",
    "pin": "482910"
  },
  "message": "Request Successful!",
  "success": true
}

Reutilizar un número

Vuelve a pedir el mismo número para otro código, si el servicio lo permite.

POST/reuse-s2-service
ParámetroTipoObligatorioDescripción
orderIdstringSíEl ID del pedido, tal como se devolvió al hacer el pedido.
Ejemplo de solicitud
curl -X POST "https://textverification.io/api/v1/users/reuse-s2-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"lr_01K7ABC"}'
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": {
    "orderId": "lr_01K7ABC",
    "number": "12125550102",
    "serviceName": "google",
    "country": "United States",
    "areas": "212,646",
    "carrier": "vz,att",
    "capability": "sms",
    "price": "1.53",
    "status": "reserved",
    "expiredIn": 600
  },
  "message": "Request Successful!",
  "success": true
}

Cancelar un número

Cancela un número que aún no ha recibido ningún código y reembolsa el importe a tu saldo.

POST/reject-s2-service
ParámetroTipoObligatorioDescripción
orderIdstringSíEl ID del pedido, tal como se devolvió al hacer el pedido.
Ejemplo de solicitud
curl -X POST "https://textverification.io/api/v1/users/reject-s2-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"lr_01K7ABC"}'
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": null,
  "message": "Request Successful!",
  "success": true
}

Obtener un token de llamada de voz

Devuelve un token de corta duración para atender la llamada de un pedido de voz con el Voice SDK de Twilio.

GET/s2-voice-token
ParámetroTipoObligatorioDescripción
orderIdstringSíEl ID del pedido, tal como se devolvió al hacer el pedido.
Ejemplo de solicitud
curl "https://textverification.io/api/v1/users/s2-voice-token?orderId=lr_01K7ABC" \
  -H "Authorization: Bearer YOUR_API_KEY"
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": {
    "orderId": "lr_01K7ABC",
    "token": "eyJhbGciOi…",
    "expiresIn": 540
  },
  "message": "Request Successful!",
  "success": true
}

Descargar la grabación de una llamada

Devuelve la grabación de la llamada de un pedido de voz, si se conservó.

GET/s2-voice-recording
ParámetroTipoObligatorioDescripción
orderIdstringSíEl ID del pedido, tal como se devolvió al hacer el pedido.
callIdstringSíEl ID de la llamada, de las llamadas del pedido.
Ejemplo de solicitud
curl "https://textverification.io/api/v1/users/s2-voice-recording?orderId=lr_01K7ABC&callId=call_8f2" \
  -H "Authorization: Bearer YOUR_API_KEY"
Ejemplo de respuesta
(audio file)

Flex

Varios códigos de área y un operador en un solo pedido, en EE. UU. y en otros países disponibles.

Listar servicios y precios

Muestra los servicios de Flex con tu precio para cada uno, ya con tu descuento aplicado.

GET/server3-pricing
ParámetroTipoObligatorioDescripción
countrystringNoUn código de país de la lista de países. Omítelo para EE. UU. (o para el primer país a la venta).
Ejemplo de solicitud
curl "https://textverification.io/api/v1/users/server3-pricing" \
  -H "Authorization: Bearer YOUR_API_KEY"
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": [
    {
      "serviceId": "9a1c55e0",
      "serviceName": "Telegram",
      "price": "0.40"
    }
  ],
  "message": "Request Successful!",
  "success": true
}

Listar países

Muestra los países en los que Flex vende números, con sus códigos.

GET/server3-countries
Ejemplo de solicitud
curl "https://textverification.io/api/v1/users/server3-countries" \
  -H "Authorization: Bearer YOUR_API_KEY"
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": [
    {
      "code": "us",
      "name": "United States"
    }
  ],
  "message": "Request Successful!",
  "success": true
}

Pedir un número

Pide un número de Flex para un servicio y lo cobra de tu saldo.

POST/request-s3-service
ParámetroTipoObligatorioDescripción
serviceIdstringSíEl ID del servicio, de la lista de servicios.
areasstringNoCódigos de área, separados por comas (hasta 10). Aumentan el precio.
carrierstringNo"att" o "tmo". Aumenta el precio.
countrystringNoUn código de país de la lista de países. Omítelo para EE. UU. (o para el primer país a la venta).
Ejemplo de solicitud
curl -X POST "https://textverification.io/api/v1/users/request-s3-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"serviceId":"9a1c55e0","areas":"212,646","carrier":"tmo"}'
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": {
    "orderId": "48211973",
    "number": "16465550103",
    "serviceName": "Telegram",
    "country": "United States",
    "status": "reserved",
    "areas": "212,646",
    "carrier": "tmo",
    "price": "0.58",
    "expiredIn": 600
  },
  "message": "Request Successful!",
  "success": true
}

Consultar un pedido

Devuelve un pedido con su estado y, cuando haya llegado, el código.

GET/number-details-s3
ParámetroTipoObligatorioDescripción
orderIdstringSíEl ID del pedido, tal como se devolvió al hacer el pedido.
Ejemplo de solicitud
curl "https://textverification.io/api/v1/users/number-details-s3?orderId=48211973" \
  -H "Authorization: Bearer YOUR_API_KEY"
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": {
    "orderId": "48211973",
    "number": "16465550103",
    "serviceName": "Telegram",
    "country": "United States",
    "price": "0.58",
    "createdAt": "2026-10-09 12:44:00",
    "status": "completed",
    "message": "Your code is 482910",
    "pin": "482910"
  },
  "message": "Request Successful!",
  "success": true
}

Reutilizar un número

Vuelve a pedir el mismo número para otro código, si el servicio lo permite.

POST/reuse-s3-service
ParámetroTipoObligatorioDescripción
orderIdstringSíEl ID del pedido, tal como se devolvió al hacer el pedido.
Ejemplo de solicitud
curl -X POST "https://textverification.io/api/v1/users/reuse-s3-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"48211973"}'
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": {
    "orderId": "48211973",
    "number": "16465550103",
    "serviceName": "Telegram",
    "country": "United States",
    "price": "0.58",
    "status": "reserved",
    "expiredIn": 600
  },
  "message": "Request Successful!",
  "success": true
}

Cancelar un número

Cancela un número que aún no ha recibido ningún código y reembolsa el importe a tu saldo.

POST/reject-s3-service
ParámetroTipoObligatorioDescripción
orderIdstringSíEl ID del pedido, tal como se devolvió al hacer el pedido.
Ejemplo de solicitud
curl -X POST "https://textverification.io/api/v1/users/reject-s3-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"48211973"}'
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": null,
  "message": "Request Successful!",
  "success": true
}

Global

Números de muchos países: consulta la lista de países y luego pide un número para un servicio en uno de ellos.

Listar servicios y precios

Muestra los servicios de Global con tu precio para cada uno, ya con tu descuento aplicado.

GET/server4-pricing
ParámetroTipoObligatorioDescripción
countrystringNoUn código de país de la lista de países. Omítelo para EE. UU. (o para el primer país a la venta).
Ejemplo de solicitud
curl "https://textverification.io/api/v1/users/server4-pricing?country=gb" \
  -H "Authorization: Bearer YOUR_API_KEY"
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": [
    {
      "serviceId": "c41e7a02",
      "serviceName": "WhatsApp",
      "price": "0.35"
    }
  ],
  "message": "Request Successful!",
  "success": true
}

Listar países

Muestra los países en los que Global vende números, con sus códigos.

GET/server4-countries
Ejemplo de solicitud
curl "https://textverification.io/api/v1/users/server4-countries" \
  -H "Authorization: Bearer YOUR_API_KEY"
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": [
    {
      "code": "us",
      "name": "United States"
    },
    {
      "code": "gb",
      "name": "United Kingdom"
    }
  ],
  "message": "Request Successful!",
  "success": true
}

Obtener opciones de verificación y operador

Indica si un servicio puede verificarse por FlashCall + SMS en un país y los operadores de los que pueden venir los números, con el precio de cada opción.

GET/server4-options
ParámetroTipoObligatorioDescripción
serviceIdstringSíEl ID del servicio, de la lista de servicios.
countrystringNoUn código de país de la lista de países. Omítelo para EE. UU. (o para el primer país a la venta).
Ejemplo de solicitud
curl "https://textverification.io/api/v1/users/server4-options?serviceId=c41e7a02&country=us" \
  -H "Authorization: Bearer YOUR_API_KEY"
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": {
    "price": "2.70",
    "call": {
      "price": "3.00"
    },
    "carriers": {
      "surcharge": 20,
      "operators": [
        {
          "code": "at_t",
          "name": "AT&T"
        },
        {
          "code": "tmobile",
          "name": "T-Mobile"
        },
        {
          "code": "verizon",
          "name": "Verizon"
        }
      ],
      "price": "3.24",
      "callPrice": "3.60"
    }
  },
  "message": "Request Successful!",
  "success": true
}

Pedir un número

Pide un número de Global para un servicio y lo cobra de tu saldo.

POST/request-s4-service
ParámetroTipoObligatorioDescripción
serviceIdstringSíEl ID del servicio, de la lista de servicios.
countrystringNoUn código de país de la lista de países. Omítelo para EE. UU. (o para el primer país a la venta).
verificationstringNo"call" para FlashCall + SMS: el servicio llama al número y el número que llama es el código. "sms" por defecto.
operatorstringNoEl código de un operador del endpoint de opciones, para recibir un número solo de ese operador. Añade el recargo por operador. Cualquier operador por defecto.
Ejemplo de solicitud
curl -X POST "https://textverification.io/api/v1/users/request-s4-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"serviceId":"c41e7a02","country":"us","operator":"tmobile"}'
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": {
    "orderId": "3311842",
    "number": "12125550142",
    "serviceName": "WhatsApp",
    "country": "United States",
    "status": "reserved",
    "price": "3.24",
    "expiredIn": 1200,
    "carrier": "T-Mobile"
  },
  "message": "Request Successful!",
  "success": true
}

Consultar un pedido

Devuelve un pedido con su estado y, cuando haya llegado, el código.

GET/number-details-s4
ParámetroTipoObligatorioDescripción
orderIdstringSíEl ID del pedido, tal como se devolvió al hacer el pedido.
Ejemplo de solicitud
curl "https://textverification.io/api/v1/users/number-details-s4?orderId=3311842" \
  -H "Authorization: Bearer YOUR_API_KEY"
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": {
    "orderId": "3311842",
    "number": "12125550142",
    "serviceName": "WhatsApp",
    "country": "United States",
    "price": "3.24",
    "createdAt": "2026-10-09 12:44:00",
    "status": "completed",
    "message": "Your code is 482910",
    "pin": "482910"
  },
  "message": "Request Successful!",
  "success": true
}

Reutilizar un número

Vuelve a pedir el mismo número para otro código, si el servicio lo permite.

POST/reuse-s4-service
ParámetroTipoObligatorioDescripción
orderIdstringSíEl ID del pedido, tal como se devolvió al hacer el pedido.
Ejemplo de solicitud
curl -X POST "https://textverification.io/api/v1/users/reuse-s4-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"3311842"}'
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": {
    "orderId": "3311842",
    "number": "12125550142",
    "serviceName": "WhatsApp",
    "country": "United States",
    "price": "3.24",
    "status": "reserved",
    "expiredIn": 600
  },
  "message": "Request Successful!",
  "success": true
}

Cancelar un número

Cancela un número que aún no ha recibido ningún código y reembolsa el importe a tu saldo.

POST/reject-s4-service
ParámetroTipoObligatorioDescripción
orderIdstringSíEl ID del pedido, tal como se devolvió al hacer el pedido.
Ejemplo de solicitud
curl -X POST "https://textverification.io/api/v1/users/reject-s4-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"3311842"}'
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": null,
  "message": "Request Successful!",
  "success": true
}

Smart

Números económicos de muchos países, con códigos de área, prioridad y hasta 5 números por solicitud.

Listar servicios y precios

Muestra los servicios de Smart con tu precio para cada uno, ya con tu descuento aplicado.

GET/server5-pricing
ParámetroTipoObligatorioDescripción
countrystringNoUn código de país de la lista de países. Omítelo para EE. UU. (o para el primer país a la venta).
Ejemplo de solicitud
curl "https://textverification.io/api/v1/users/server5-pricing" \
  -H "Authorization: Bearer YOUR_API_KEY"
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": [
    {
      "serviceId": "7d0f3b11",
      "serviceName": "Telegram",
      "price": "0.12"
    }
  ],
  "message": "Request Successful!",
  "success": true
}

Listar países

Muestra los países en los que Smart vende números, con sus códigos.

GET/server5-countries
Ejemplo de solicitud
curl "https://textverification.io/api/v1/users/server5-countries" \
  -H "Authorization: Bearer YOUR_API_KEY"
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": [
    {
      "code": "us",
      "name": "United States"
    }
  ],
  "message": "Request Successful!",
  "success": true
}

Obtener las opciones de pedido

Devuelve los códigos de área disponibles para un servicio en un país y cuánto aumentan el precio.

GET/server5-options
ParámetroTipoObligatorioDescripción
serviceIdstringSíEl ID del servicio, de la lista de servicios.
countrystringNoUn código de país de la lista de países. Omítelo para EE. UU. (o para el primer país a la venta).
Ejemplo de solicitud
curl "https://textverification.io/api/v1/users/server5-options?serviceId=7d0f3b11&country=us" \
  -H "Authorization: Bearer YOUR_API_KEY"
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": {
    "price": "0.12",
    "successRate": 61,
    "bestSuccess": {
      "price": "0.15",
      "successRate": 84
    },
    "areaCodes": {
      "surcharge": 20,
      "lines": [
        {
          "price": "0.17",
          "successRate": 84,
          "codes": [
            "212",
            "646"
          ]
        }
      ]
    }
  },
  "message": "Request Successful!",
  "success": true
}

Pedir un número

Pide un número de Smart para un servicio y lo cobra de tu saldo.

POST/request-s5-service
ParámetroTipoObligatorioDescripción
serviceIdstringSíEl ID del servicio, de la lista de servicios.
countrystringNoUn código de país de la lista de países. Omítelo para EE. UU. (o para el primer país a la venta).
areaCodesstring[]NoCódigos de área que quieres obtener, o evitar con excludeAreaCodes: en una lista o separados por comas, hasta 10. Aumentan el precio.
excludeAreaCodesbooleanNotrue para evitar esos códigos de área en lugar de obtener uno de ellos.
prioritystringNo"price" (predeterminado) para el precio más bajo, o "success" para la línea con más probabilidades de entregar tu código.
quantitynumberNoCuántos números pedir a la vez, de 1 a 5. Cada uno se convierte en un pedido aparte.
phoneNumberstringNoUn número concreto que ya tuviste, en dígitos con el código de país, si vuelve a estar libre.

Con una cantidad mayor que 1, la respuesta incluye todos los pedidos realizados; si se pudieron pedir menos, indica cuántos y por qué.

Ejemplo de solicitud
curl -X POST "https://textverification.io/api/v1/users/request-s5-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"serviceId":"7d0f3b11","areaCodes":["212"],"priority":"success"}'
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": {
    "orderId": "AB12CD34",
    "number": "12125550105",
    "serviceName": "Telegram",
    "country": "United States",
    "status": "reserved",
    "price": "0.14",
    "expiredIn": 1200
  },
  "message": "Request Successful!",
  "success": true
}

Consultar un pedido

Devuelve un pedido con su estado y, cuando haya llegado, el código.

GET/number-details-s5
ParámetroTipoObligatorioDescripción
orderIdstringSíEl ID del pedido, tal como se devolvió al hacer el pedido.
Ejemplo de solicitud
curl "https://textverification.io/api/v1/users/number-details-s5?orderId=AB12CD34" \
  -H "Authorization: Bearer YOUR_API_KEY"
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": {
    "orderId": "AB12CD34",
    "number": "12125550105",
    "serviceName": "Telegram",
    "country": "United States",
    "price": "0.14",
    "createdAt": "2026-10-09 12:44:00",
    "status": "completed",
    "message": "Your code is 482910",
    "pin": "482910"
  },
  "message": "Request Successful!",
  "success": true
}

Reutilizar un número

Vuelve a pedir el mismo número para otro código, si el servicio lo permite.

POST/reuse-s5-service
ParámetroTipoObligatorioDescripción
orderIdstringSíEl ID del pedido, tal como se devolvió al hacer el pedido.
Ejemplo de solicitud
curl -X POST "https://textverification.io/api/v1/users/reuse-s5-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"AB12CD34"}'
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": {
    "orderId": "AB12CD34",
    "number": "12125550105",
    "serviceName": "Telegram",
    "country": "United States",
    "price": "0.14",
    "status": "reserved",
    "expiredIn": 600
  },
  "message": "Request Successful!",
  "success": true
}

Cancelar un número

Cancela un número que aún no ha recibido ningún código y reembolsa el importe a tu saldo.

POST/reject-s5-service
ParámetroTipoObligatorioDescripción
orderIdstringSíEl ID del pedido, tal como se devolvió al hacer el pedido.
Ejemplo de solicitud
curl -X POST "https://textverification.io/api/v1/users/reject-s5-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"AB12CD34"}'
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": null,
  "message": "Request Successful!",
  "success": true
}

Plus

Números de muchos países, cada servicio en varias líneas: pide la más barata, elige una línea o limita lo que pagas.

Listar servicios y precios

Muestra los servicios de Plus con tu precio para cada uno, ya con tu descuento aplicado.

GET/server6-pricing
ParámetroTipoObligatorioDescripción
countrystringNoUn código de país de la lista de países. Omítelo para EE. UU. (o para el primer país a la venta).
Ejemplo de solicitud
curl "https://textverification.io/api/v1/users/server6-pricing?country=us" \
  -H "Authorization: Bearer YOUR_API_KEY"
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": [
    {
      "serviceId": "5b2c9e41",
      "serviceName": "WhatsApp",
      "price": "0.68"
    }
  ],
  "message": "Request Successful!",
  "success": true
}

Listar países

Muestra los países en los que Plus vende números, con sus códigos.

GET/server6-countries
Ejemplo de solicitud
curl "https://textverification.io/api/v1/users/server6-countries" \
  -H "Authorization: Bearer YOUR_API_KEY"
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": [
    {
      "code": "us",
      "name": "United States"
    },
    {
      "code": "gb",
      "name": "United Kingdom"
    }
  ],
  "message": "Request Successful!",
  "success": true
}

Listar líneas y precios

Lista las líneas por las que se vende un servicio en un país, de la más barata a la más cara, con tu precio en cada una y su tasa de éxito cuando se conoce.

GET/server6-options
ParámetroTipoObligatorioDescripción
serviceIdstringSíEl ID del servicio, de la lista de servicios.
countrystringNoUn código de país de la lista de países. Omítelo para EE. UU. (o para el primer país a la venta).
Ejemplo de solicitud
curl "https://textverification.io/api/v1/users/server6-options?serviceId=5b2c9e41&country=us" \
  -H "Authorization: Bearer YOUR_API_KEY"
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": {
    "price": "0.68",
    "lines": [
      {
        "lineId": "a91f03c2",
        "price": "0.68",
        "successRate": 92
      },
      {
        "lineId": "4e7d2b10",
        "price": "0.68",
        "successRate": null
      },
      {
        "lineId": "c03b5f77",
        "price": "1.08",
        "successRate": 97
      }
    ]
  },
  "message": "Request Successful!",
  "success": true
}

Pedir un número

Pide un número de Plus para un servicio y lo cobra de tu saldo.

POST/request-s6-service
ParámetroTipoObligatorioDescripción
serviceIdstringSíEl ID del servicio, de la lista de servicios.
countrystringNoUn código de país de la lista de países. Omítelo para EE. UU. (o para el primer país a la venta).
lineIdstringNoUna línea de la lista de líneas. Omítelo para usar la más barata.
maxPricenumberNoLo máximo que pagarás, en dólares estadounidenses. Un precio mayor se rechaza; sin lineId, puede usarse cualquier línea hasta ese precio.

Sin lineId se usa la línea más barata, y otra línea al mismo precio si no tiene números. Si una línea no entrega códigos de un servicio, rechaza el número y pide desde otra lineId.

Ejemplo de solicitud
curl -X POST "https://textverification.io/api/v1/users/request-s6-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"serviceId":"5b2c9e41","country":"us","maxPrice":0.7}'
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": {
    "orderId": "230698",
    "number": "15551230456",
    "serviceName": "WhatsApp",
    "country": "United States",
    "status": "reserved",
    "price": "0.68",
    "expiredIn": 1200,
    "lineId": "a91f03c2"
  },
  "message": "Request Successful!",
  "success": true
}

Consultar un pedido

Devuelve un pedido con su estado y, cuando haya llegado, el código.

GET/number-details-s6
ParámetroTipoObligatorioDescripción
orderIdstringSíEl ID del pedido, tal como se devolvió al hacer el pedido.
Ejemplo de solicitud
curl "https://textverification.io/api/v1/users/number-details-s6?orderId=230698" \
  -H "Authorization: Bearer YOUR_API_KEY"
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": {
    "orderId": "230698",
    "number": "15551230456",
    "serviceName": "WhatsApp",
    "country": "United States",
    "price": "0.68",
    "lineId": "a91f03c2",
    "createdAt": "2026-10-09 12:44:00",
    "status": "completed",
    "message": "Your code is 482910",
    "pin": "482910"
  },
  "message": "Request Successful!",
  "success": true
}

Reutilizar un número

Vuelve a pedir el mismo número para otro código, si el servicio lo permite.

POST/reuse-s6-service
ParámetroTipoObligatorioDescripción
orderIdstringSíEl ID del pedido, tal como se devolvió al hacer el pedido.
Ejemplo de solicitud
curl -X POST "https://textverification.io/api/v1/users/reuse-s6-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"230698"}'
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": {
    "orderId": "230698",
    "number": "15551230456",
    "serviceName": "WhatsApp",
    "country": "United States",
    "price": "0.68",
    "lineId": "a91f03c2",
    "status": "reserved",
    "expiredIn": 600
  },
  "message": "Request Successful!",
  "success": true
}

Cancelar un número

Cancela un número que aún no ha recibido ningún código y reembolsa el importe a tu saldo.

POST/reject-s6-service
ParámetroTipoObligatorioDescripción
orderIdstringSíEl ID del pedido, tal como se devolvió al hacer el pedido.
Ejemplo de solicitud
curl -X POST "https://textverification.io/api/v1/users/reject-s6-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"230698"}'
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": null,
  "message": "Request Successful!",
  "success": true
}

Express

Números de EE. UU. para un código rápido: haz un pedido para un servicio y recibe el código en los detalles del pedido o con un callback dentro de los 5 minutos del número.

Listar servicios y precios

Muestra los servicios de Express con tu precio para cada uno, ya con tu descuento aplicado.

GET/server7-pricing
Ejemplo de solicitud
curl "https://textverification.io/api/v1/users/server7-pricing" \
  -H "Authorization: Bearer YOUR_API_KEY"
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": [
    {
      "serviceId": "3e7a91c0",
      "serviceName": "WhatsApp",
      "price": "0.75",
      "multiplePrice": "1.13",
      "smsModes": [
        "single",
        "multiple"
      ]
    },
    {
      "serviceId": "8b2c40d1",
      "serviceName": "Telegram",
      "price": "0.50",
      "multiplePrice": null,
      "smsModes": [
        "single"
      ]
    }
  ],
  "message": "Request Successful!",
  "success": true
}

Pedir un número

Pide un número de Express para un servicio y lo cobra de tu saldo.

POST/request-s7-service
ParámetroTipoObligatorioDescripción
serviceIdstringSíEl ID del servicio, de la lista de servicios.
smsModestringNo"multiple" para recibir cada SMS enviado al número mientras está activo (5 minutos), entregado en cuanto llega, al multiplePrice del servicio. Solo para servicios cuyos smsModes incluyen "multiple". "single" por defecto, o "multiple" para un servicio que solo se vende así.

Un número Express está activo durante 5 minutos. Si no llega ningún código en ese tiempo, el pedido se cancela y se reembolsa automáticamente. Los números Express no se pueden reutilizar. Con smsMode "multiple", el número sigue recibiendo códigos durante sus 5 minutos: cada código nuevo envía otro callback s7_otp_received, y los detalles del pedido listan todos los códigos, el más reciente como pin.

Ejemplo de solicitud
curl -X POST "https://textverification.io/api/v1/users/request-s7-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"serviceId":"3e7a91c0","smsMode":"multiple"}'
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": {
    "orderId": "9f2c41ab07d3e815",
    "number": "12125550142",
    "serviceName": "WhatsApp",
    "country": "United States",
    "status": "reserved",
    "price": "1.13",
    "expiredIn": 300,
    "smsMode": "multiple"
  },
  "message": "Request Successful!",
  "success": true
}

Consultar un pedido

Devuelve un pedido con su estado y, cuando haya llegado, el código.

GET/number-details-s7
ParámetroTipoObligatorioDescripción
orderIdstringSíEl ID del pedido, tal como se devolvió al hacer el pedido.
Ejemplo de solicitud
curl "https://textverification.io/api/v1/users/number-details-s7?orderId=9f2c41ab07d3e815" \
  -H "Authorization: Bearer YOUR_API_KEY"
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": {
    "orderId": "9f2c41ab07d3e815",
    "number": "12125550142",
    "serviceName": "WhatsApp",
    "country": "United States",
    "price": "1.13",
    "smsMode": "multiple",
    "codes": [
      {
        "code": "318204",
        "message": "Your code is 318204",
        "receivedAt": "2026-10-09 12:44:00"
      },
      {
        "code": "482910",
        "message": "Your code is 482910",
        "receivedAt": "2026-10-09 12:44:00"
      }
    ],
    "createdAt": "2026-10-09 12:44:00",
    "status": "completed",
    "message": "Your code is 482910",
    "pin": "482910"
  },
  "message": "Request Successful!",
  "success": true
}

Cancelar un número

Cancela un número que aún no ha recibido ningún código y reembolsa el importe a tu saldo.

POST/reject-s7-service
ParámetroTipoObligatorioDescripción
orderIdstringSíEl ID del pedido, tal como se devolvió al hacer el pedido.
Ejemplo de solicitud
curl -X POST "https://textverification.io/api/v1/users/reject-s7-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"9f2c41ab07d3e815"}'
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": null,
  "message": "Request Successful!",
  "success": true
}

Alquiler Pinpoint

Conserva un número de EE. UU. para un servicio de 1 día a un año, con renovaciones y renovación automática.

Listar servicios y precios de alquiler

Muestra los servicios de Alquiler Pinpoint con tu precio para cada periodo de alquiler.

GET/rental-services
Ejemplo de solicitud
curl "https://textverification.io/api/v1/users/rental-services" \
  -H "Authorization: Bearer YOUR_API_KEY"
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": [
    {
      "serviceId": "rg5e1d20",
      "serviceName": "whatsapp"
    }
  ],
  "message": "Request Successful!",
  "success": true
}

Consultar el precio de un alquiler

Devuelve tu precio para cada periodo de alquiler de un servicio, con o sin códigos de área.

GET/rental-prices
ParámetroTipoObligatorioDescripción
serviceIdstringSíEl ID del servicio, de la lista de servicios.
areasstringNoCódigos de área, separados por comas (hasta 10). Aumentan el precio.

No todos los servicios ofrecen todos los periodos: este endpoint devuelve los periodos por los que se puede alquilar un servicio.

Ejemplo de solicitud
curl "https://textverification.io/api/v1/users/rental-prices?serviceId=rg5e1d20" \
  -H "Authorization: Bearer YOUR_API_KEY"
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": [
    {
      "label": "oneDay",
      "days": 1,
      "price": "2.85"
    },
    {
      "label": "thirtyDay",
      "days": 30,
      "price": "7.20"
    },
    {
      "label": "oneYear",
      "days": 365,
      "price": "72.00"
    }
  ],
  "message": "Request Successful!",
  "success": true
}

Alquilar un número

Alquila un número de Alquiler Pinpoint para un servicio y cobra de tu saldo el periodo completo.

POST/request-rental
ParámetroTipoObligatorioDescripción
serviceIdstringSíEl ID del servicio, de la lista de servicios.
durationstringSíLa duración del alquiler: oneDay, threeDay, sevenDay, fourteenDay, thirtyDay, ninetyDay o oneYear.
areasstringNoCódigos de área, separados por comas (hasta 10). Aumentan el precio.
autoRenewbooleanNotrue para renovar el alquiler con tu saldo unas horas antes de que termine.
Ejemplo de solicitud
curl -X POST "https://textverification.io/api/v1/users/request-rental" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"serviceId":"rg5e1d20","duration":"thirtyDay","autoRenew":true}'
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": {
    "orderId": "6702f1c4e2",
    "number": "12125550104",
    "serviceName": "WhatsApp",
    "country": "United States",
    "price": "7.20",
    "status": "reserved",
    "canRefund": true,
    "autoRenew": true,
    "purchased": "2026-10-09 12:44:00",
    "expires": "2026-11-08 12:44:00",
    "period": "thirtyDay",
    "duration": 30,
    "renewals": 0
  },
  "message": "Request Successful!",
  "success": true
}

Leer los mensajes de un alquiler

Devuelve los mensajes que ha recibido un alquiler, del más reciente al más antiguo.

GET/rental-messages
ParámetroTipoObligatorioDescripción
orderIdstringSíEl ID del pedido, tal como se devolvió al hacer el pedido.
page / limitnumberNoNúmero de página y tamaño de página (hasta 100).
Ejemplo de solicitud
curl "https://textverification.io/api/v1/users/rental-messages?orderId=6702f1c4e2" \
  -H "Authorization: Bearer YOUR_API_KEY"
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": {
    "messages": [
      {
        "id": "66f0a1",
        "orderId": "6702f1c4e2",
        "number": "12125550104",
        "service": "WhatsApp",
        "sender": "WhatsApp",
        "message": "Your WhatsApp code: 551-204",
        "pin": "551204",
        "timestamp": "2026-10-09 12:44:00"
      }
    ],
    "pagination": {
      "total": 1,
      "page": 1,
      "limit": 10,
      "totalPages": 1
    }
  },
  "message": "Request Successful!",
  "success": true
}

Consultar precios de renovación

Muestra los periodos por los que se puede renovar un alquiler activo, con tu precio para cada uno.

GET/rental-renew-options
ParámetroTipoObligatorioDescripción
orderIdstringSíEl ID del pedido, tal como se devolvió al hacer el pedido.
Ejemplo de solicitud
curl "https://textverification.io/api/v1/users/rental-renew-options?orderId=6702f1c4e2" \
  -H "Authorization: Bearer YOUR_API_KEY"
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": {
    "orderId": "6702f1c4e2",
    "number": "12125550104",
    "serviceName": "whatsapp",
    "periods": [
      {
        "period": "thirtyDay",
        "days": 30,
        "price": "7.20"
      }
    ]
  },
  "message": "Request Successful!",
  "success": true
}

Renovar un alquiler

Amplía un alquiler activo y lo cobra de tu saldo. Si no indicas un periodo, se renueva por su misma duración.

POST/renew-rental
ParámetroTipoObligatorioDescripción
orderIdstringSíEl ID del pedido, tal como se devolvió al hacer el pedido.
periodstringNoEl periodo de renovación (mismos valores que duration). Omítelo para renovar por la misma duración del alquiler.
Ejemplo de solicitud
curl -X POST "https://textverification.io/api/v1/users/renew-rental" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"6702f1c4e2","period":"thirtyDay"}'
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": {
    "orderId": "6702f1c4e2",
    "number": "12125550104",
    "serviceName": "WhatsApp",
    "country": "United States",
    "price": "14.40",
    "status": "reserved",
    "canRefund": false,
    "autoRenew": true,
    "purchased": "2026-10-09 12:44:00",
    "expires": "2026-11-08 12:44:00",
    "period": "thirtyDay",
    "duration": 30,
    "renewals": 1
  },
  "message": "Request Successful!",
  "success": true
}

Activar o desactivar la renovación automática

Define si un alquiler activo se renueva con tu saldo unas horas antes de que termine.

POST/rental-auto-renew
ParámetroTipoObligatorioDescripción
orderIdstringSíEl ID del pedido, tal como se devolvió al hacer el pedido.
enabledbooleanSítrue para activar la renovación automática, false para desactivarla.
Ejemplo de solicitud
curl -X POST "https://textverification.io/api/v1/users/rental-auto-renew" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"6702f1c4e2","enabled":false}'
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": {
    "orderId": "6702f1c4e2",
    "autoRenew": false
  },
  "message": "Request Successful!",
  "success": true
}

Cancelar un alquiler

Cancela un alquiler que todavía se puede reembolsar (antes de su primer mensaje) y reembolsa el importe a tu saldo.

POST/release-rental
ParámetroTipoObligatorioDescripción
orderIdstringSíEl ID del pedido, tal como se devolvió al hacer el pedido.
Ejemplo de solicitud
curl -X POST "https://textverification.io/api/v1/users/release-rental" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"6702f1c4e2"}'
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": null,
  "message": "Request Successful!",
  "success": true
}

Alquiler Flex

Conserva un número de EE. UU. de 1 a 30 días, con renovación automática y reactivación de números expirados.

Listar servicios y precios de alquiler

Muestra los servicios de Alquiler Flex con tu precio para cada periodo de alquiler.

GET/s3-rental-services
ParámetroTipoObligatorioDescripción
countrystringNoUn código de país de la lista de países. Omítelo para EE. UU. (o para el primer país a la venta).
Ejemplo de solicitud
curl "https://textverification.io/api/v1/users/s3-rental-services" \
  -H "Authorization: Bearer YOUR_API_KEY"
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": [
    {
      "serviceId": "1f3aa214",
      "serviceName": "Amazon",
      "prices": [
        {
          "period": "1d",
          "days": 1,
          "price": "2.88"
        },
        {
          "period": "30d",
          "days": 30,
          "price": "5.76"
        }
      ]
    }
  ],
  "message": "Request Successful!",
  "success": true
}

Listar países

Muestra los países en los que Alquiler Flex vende números, con sus códigos.

GET/s3-rental-countries
Ejemplo de solicitud
curl "https://textverification.io/api/v1/users/s3-rental-countries" \
  -H "Authorization: Bearer YOUR_API_KEY"
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": [
    {
      "code": "us",
      "name": "United States"
    }
  ],
  "message": "Request Successful!",
  "success": true
}

Alquilar un número

Alquila un número de Alquiler Flex para un servicio y cobra de tu saldo el periodo completo.

POST/request-s3-rental
ParámetroTipoObligatorioDescripción
serviceIdstringSíEl ID del servicio, de la lista de servicios.
periodstringSíLa duración del alquiler, de la lista de servicios, como "7d".
areasstringNoCódigos de área, separados por comas (hasta 10). Aumentan el precio.
autoRenewbooleanNotrue para renovar el alquiler con tu saldo unas horas antes de que termine.
countrystringNoUn código de país de la lista de países. Omítelo para EE. UU. (o para el primer país a la venta).
Ejemplo de solicitud
curl -X POST "https://textverification.io/api/v1/users/request-s3-rental" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"serviceId":"1f3aa214","period":"7d","autoRenew":true}'
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": {
    "orderId": "6702f1c4e2",
    "number": "12125550104",
    "serviceName": "WhatsApp",
    "country": "United States",
    "price": "3.20",
    "status": "reserved",
    "canRefund": true,
    "autoRenew": true,
    "purchased": "2026-10-09 12:44:00",
    "expires": "2026-11-08 12:44:00",
    "period": "7d",
    "duration": 7,
    "renewPrice": "3.20"
  },
  "message": "Request Successful!",
  "success": true
}

Consultar un alquiler

Devuelve un alquiler con su estado, su fecha de finalización y su configuración de renovación.

GET/s3-rental-details
ParámetroTipoObligatorioDescripción
orderIdstringSíEl ID del pedido, tal como se devolvió al hacer el pedido.
Ejemplo de solicitud
curl "https://textverification.io/api/v1/users/s3-rental-details?orderId=6702f1c4e2" \
  -H "Authorization: Bearer YOUR_API_KEY"
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": {
    "orderId": "6702f1c4e2",
    "number": "12125550104",
    "serviceName": "WhatsApp",
    "country": "United States",
    "price": "3.20",
    "status": "active",
    "canRefund": false,
    "autoRenew": true,
    "purchased": "2026-10-09 12:44:00",
    "expires": "2026-11-08 12:44:00",
    "period": "7d",
    "duration": 7
  },
  "message": "Request Successful!",
  "success": true
}

Leer los mensajes de un alquiler

Devuelve los mensajes que ha recibido un alquiler, del más reciente al más antiguo.

GET/s3-rental-messages
ParámetroTipoObligatorioDescripción
orderIdstringSíEl ID del pedido, tal como se devolvió al hacer el pedido.
page / limitnumberNoNúmero de página y tamaño de página (hasta 100).
Ejemplo de solicitud
curl "https://textverification.io/api/v1/users/s3-rental-messages?orderId=6702f1c4e2" \
  -H "Authorization: Bearer YOUR_API_KEY"
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": {
    "messages": [
      {
        "id": "66f0a1",
        "orderId": "6702f1c4e2",
        "number": "12125550104",
        "service": "WhatsApp",
        "sender": "WhatsApp",
        "message": "Your WhatsApp code: 551-204",
        "pin": "551204",
        "timestamp": "2026-10-09 12:44:00"
      }
    ],
    "pagination": {
      "total": 1,
      "page": 1,
      "limit": 10,
      "totalPages": 1
    }
  },
  "message": "Request Successful!",
  "success": true
}

Renovar un alquiler

Amplía un alquiler activo y lo cobra de tu saldo. Si no indicas un periodo, se renueva por su misma duración.

POST/renew-s3-rental
ParámetroTipoObligatorioDescripción
orderIdstringSíEl ID del pedido, tal como se devolvió al hacer el pedido.
Ejemplo de solicitud
curl -X POST "https://textverification.io/api/v1/users/renew-s3-rental" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"6702f1c4e2"}'
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": {
    "orderId": "6702f1c4e2",
    "number": "12125550104",
    "serviceName": "WhatsApp",
    "country": "United States",
    "price": "6.40",
    "status": "reserved",
    "canRefund": false,
    "autoRenew": true,
    "purchased": "2026-10-09 12:44:00",
    "expires": "2026-11-08 12:44:00",
    "period": "7d",
    "duration": 7
  },
  "message": "Request Successful!",
  "success": true
}

Activar o desactivar la renovación automática

Define si un alquiler activo se renueva con tu saldo unas horas antes de que termine.

POST/s3-rental-auto-renew
ParámetroTipoObligatorioDescripción
orderIdstringSíEl ID del pedido, tal como se devolvió al hacer el pedido.
enabledbooleanSítrue para activar la renovación automática, false para desactivarla.
Ejemplo de solicitud
curl -X POST "https://textverification.io/api/v1/users/s3-rental-auto-renew" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"6702f1c4e2","enabled":true}'
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": {
    "orderId": "6702f1c4e2",
    "autoRenew": true
  },
  "message": "Request Successful!",
  "success": true
}

Cancelar un alquiler

Cancela un alquiler que todavía se puede reembolsar (antes de su primer mensaje) y reembolsa el importe a tu saldo.

POST/cancel-s3-rental
ParámetroTipoObligatorioDescripción
orderIdstringSíEl ID del pedido, tal como se devolvió al hacer el pedido.
Ejemplo de solicitud
curl -X POST "https://textverification.io/api/v1/users/cancel-s3-rental" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"6702f1c4e2"}'
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": null,
  "message": "Request Successful!",
  "success": true
}

Consultar precios de reactivación

Muestra los periodos por los que se puede reactivar el número de un alquiler expirado, con tu precio para cada uno.

GET/s3-rental-retake-options
ParámetroTipoObligatorioDescripción
orderIdstringSíEl ID del pedido, tal como se devolvió al hacer el pedido.
Ejemplo de solicitud
curl "https://textverification.io/api/v1/users/s3-rental-retake-options?orderId=6702f1c4e2" \
  -H "Authorization: Bearer YOUR_API_KEY"
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": {
    "orderId": "6702f1c4e2",
    "number": "12125550104",
    "serviceName": "Amazon",
    "periods": [
      {
        "period": "7d",
        "days": 7,
        "price": "4.80"
      }
    ]
  },
  "message": "Request Successful!",
  "success": true
}

Reactivar un número expirado

Vuelve a alquilar el número de un alquiler expirado para el mismo servicio, mientras siga libre.

POST/retake-s3-rental
ParámetroTipoObligatorioDescripción
orderIdstringSíEl ID del pedido, tal como se devolvió al hacer el pedido.
periodstringSíLa duración del alquiler, de la lista de servicios, como "7d".
autoRenewbooleanNotrue para renovar el alquiler con tu saldo unas horas antes de que termine.
Ejemplo de solicitud
curl -X POST "https://textverification.io/api/v1/users/retake-s3-rental" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"6702f1c4e2","period":"7d"}'
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": {
    "orderId": "6702f9a811",
    "number": "12125550104",
    "serviceName": "WhatsApp",
    "country": "United States",
    "price": "4.80",
    "status": "reserved",
    "canRefund": true,
    "autoRenew": true,
    "purchased": "2026-10-09 12:44:00",
    "expires": "2026-11-08 12:44:00",
    "period": "7d",
    "duration": 7
  },
  "message": "Request Successful!",
  "success": true
}

Alquiler Global

Alquila números en muchos países, renuévalos por cualquier periodo disponible o deja que se renueven automáticamente.

Listar servicios y precios de alquiler

Muestra los servicios de Alquiler Global con tu precio para cada periodo de alquiler.

GET/s4-rental-services
ParámetroTipoObligatorioDescripción
countrystringNoUn código de país de la lista de países. Omítelo para EE. UU. (o para el primer país a la venta).
Ejemplo de solicitud
curl "https://textverification.io/api/v1/users/s4-rental-services" \
  -H "Authorization: Bearer YOUR_API_KEY"
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": [
    {
      "serviceId": "c41e7a02",
      "serviceName": "WhatsApp",
      "prices": [
        {
          "period": "1d",
          "days": 1,
          "price": "0.90"
        },
        {
          "period": "30d",
          "days": 30,
          "price": "9.60"
        }
      ]
    }
  ],
  "message": "Request Successful!",
  "success": true
}

Listar países

Muestra los países en los que Alquiler Global vende números, con sus códigos.

GET/s4-rental-countries
Ejemplo de solicitud
curl "https://textverification.io/api/v1/users/s4-rental-countries" \
  -H "Authorization: Bearer YOUR_API_KEY"
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": [
    {
      "code": "us",
      "name": "United States"
    }
  ],
  "message": "Request Successful!",
  "success": true
}

Alquilar un número

Alquila un número de Alquiler Global para un servicio y cobra de tu saldo el periodo completo.

POST/request-s4-rental
ParámetroTipoObligatorioDescripción
serviceIdstringSíEl ID del servicio, de la lista de servicios.
periodstringSíLa duración del alquiler, de la lista de servicios, como "7d".
autoRenewbooleanNotrue para renovar el alquiler con tu saldo unas horas antes de que termine.
countrystringNoUn código de país de la lista de países. Omítelo para EE. UU. (o para el primer país a la venta).
Ejemplo de solicitud
curl -X POST "https://textverification.io/api/v1/users/request-s4-rental" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"serviceId":"c41e7a02","period":"30d","country":"us"}'
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": {
    "orderId": "6702f1c4e2",
    "number": "12125550104",
    "serviceName": "WhatsApp",
    "country": "United States",
    "price": "9.60",
    "status": "reserved",
    "canRefund": true,
    "autoRenew": true,
    "purchased": "2026-10-09 12:44:00",
    "expires": "2026-11-08 12:44:00",
    "period": "30d",
    "duration": 30
  },
  "message": "Request Successful!",
  "success": true
}

Consultar un alquiler

Devuelve un alquiler con su estado, su fecha de finalización y su configuración de renovación.

GET/s4-rental-details
ParámetroTipoObligatorioDescripción
orderIdstringSíEl ID del pedido, tal como se devolvió al hacer el pedido.
Ejemplo de solicitud
curl "https://textverification.io/api/v1/users/s4-rental-details?orderId=6702f1c4e2" \
  -H "Authorization: Bearer YOUR_API_KEY"
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": {
    "orderId": "6702f1c4e2",
    "number": "12125550104",
    "serviceName": "WhatsApp",
    "country": "United States",
    "price": "9.60",
    "status": "active",
    "canRefund": false,
    "autoRenew": true,
    "purchased": "2026-10-09 12:44:00",
    "expires": "2026-11-08 12:44:00",
    "period": "30d",
    "duration": 30
  },
  "message": "Request Successful!",
  "success": true
}

Leer los mensajes de un alquiler

Devuelve los mensajes que ha recibido un alquiler, del más reciente al más antiguo.

GET/s4-rental-messages
ParámetroTipoObligatorioDescripción
orderIdstringSíEl ID del pedido, tal como se devolvió al hacer el pedido.
page / limitnumberNoNúmero de página y tamaño de página (hasta 100).
Ejemplo de solicitud
curl "https://textverification.io/api/v1/users/s4-rental-messages?orderId=6702f1c4e2" \
  -H "Authorization: Bearer YOUR_API_KEY"
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": {
    "messages": [
      {
        "id": "66f0a1",
        "orderId": "6702f1c4e2",
        "number": "12125550104",
        "service": "WhatsApp",
        "sender": "WhatsApp",
        "message": "Your WhatsApp code: 551-204",
        "pin": "551204",
        "timestamp": "2026-10-09 12:44:00"
      }
    ],
    "pagination": {
      "total": 1,
      "page": 1,
      "limit": 10,
      "totalPages": 1
    }
  },
  "message": "Request Successful!",
  "success": true
}

Consultar precios de renovación

Muestra los periodos por los que se puede renovar un alquiler activo, con tu precio para cada uno.

GET/s4-rental-renew-options
ParámetroTipoObligatorioDescripción
orderIdstringSíEl ID del pedido, tal como se devolvió al hacer el pedido.
Ejemplo de solicitud
curl "https://textverification.io/api/v1/users/s4-rental-renew-options?orderId=6702f1c4e2" \
  -H "Authorization: Bearer YOUR_API_KEY"
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": {
    "orderId": "6702f1c4e2",
    "number": "12125550104",
    "serviceName": "WhatsApp",
    "periods": [
      {
        "period": "30d",
        "days": 30,
        "price": "9.60"
      }
    ]
  },
  "message": "Request Successful!",
  "success": true
}

Renovar un alquiler

Amplía un alquiler activo y lo cobra de tu saldo. Si no indicas un periodo, se renueva por su misma duración.

POST/renew-s4-rental
ParámetroTipoObligatorioDescripción
orderIdstringSíEl ID del pedido, tal como se devolvió al hacer el pedido.
periodstringNoEl periodo de renovación, de los precios de renovación. Omítelo para renovar por la misma duración del alquiler.
Ejemplo de solicitud
curl -X POST "https://textverification.io/api/v1/users/renew-s4-rental" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"6702f1c4e2","period":"30d"}'
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": {
    "orderId": "6702f1c4e2",
    "number": "12125550104",
    "serviceName": "WhatsApp",
    "country": "United States",
    "price": "19.20",
    "status": "reserved",
    "canRefund": false,
    "autoRenew": true,
    "purchased": "2026-10-09 12:44:00",
    "expires": "2026-11-08 12:44:00",
    "period": "30d",
    "duration": 30
  },
  "message": "Request Successful!",
  "success": true
}

Activar o desactivar la renovación automática

Define si un alquiler activo se renueva con tu saldo unas horas antes de que termine.

POST/s4-rental-auto-renew
ParámetroTipoObligatorioDescripción
orderIdstringSíEl ID del pedido, tal como se devolvió al hacer el pedido.
enabledbooleanSítrue para activar la renovación automática, false para desactivarla.
Ejemplo de solicitud
curl -X POST "https://textverification.io/api/v1/users/s4-rental-auto-renew" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"6702f1c4e2","enabled":true}'
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": {
    "orderId": "6702f1c4e2",
    "autoRenew": true
  },
  "message": "Request Successful!",
  "success": true
}

Cancelar un alquiler

Cancela un alquiler que todavía se puede reembolsar (antes de su primer mensaje) y reembolsa el importe a tu saldo.

POST/cancel-s4-rental
ParámetroTipoObligatorioDescripción
orderIdstringSíEl ID del pedido, tal como se devolvió al hacer el pedido.
Ejemplo de solicitud
curl -X POST "https://textverification.io/api/v1/users/cancel-s4-rental" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"6702f1c4e2"}'
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": null,
  "message": "Request Successful!",
  "success": true
}

Consultar precios de reactivación

Muestra los periodos por los que se puede reactivar el número de un alquiler expirado, con tu precio para cada uno.

GET/s4-rental-retake-options
ParámetroTipoObligatorioDescripción
orderIdstringSíEl ID del pedido, tal como se devolvió al hacer el pedido.
Ejemplo de solicitud
curl "https://textverification.io/api/v1/users/s4-rental-retake-options?orderId=6702f1c4e2" \
  -H "Authorization: Bearer YOUR_API_KEY"
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": {
    "orderId": "6702f1c4e2",
    "number": "12125550104",
    "serviceName": "WhatsApp",
    "periods": [
      {
        "period": "30d",
        "days": 30,
        "price": "9.60"
      }
    ]
  },
  "message": "Request Successful!",
  "success": true
}

Reactivar un número expirado

Vuelve a alquilar el número de un alquiler expirado para el mismo servicio, mientras siga libre.

POST/retake-s4-rental
ParámetroTipoObligatorioDescripción
orderIdstringSíEl ID del pedido, tal como se devolvió al hacer el pedido.
periodstringSíLa duración del alquiler, de la lista de servicios, como "7d".
autoRenewbooleanNotrue para renovar el alquiler con tu saldo unas horas antes de que termine.
Ejemplo de solicitud
curl -X POST "https://textverification.io/api/v1/users/retake-s4-rental" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"6702f1c4e2","period":"30d"}'
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": {
    "orderId": "6702f9a811",
    "number": "12125550104",
    "serviceName": "WhatsApp",
    "country": "United States",
    "price": "9.60",
    "status": "reserved",
    "canRefund": true,
    "autoRenew": true,
    "purchased": "2026-10-09 12:44:00",
    "expires": "2026-11-08 12:44:00",
    "period": "30d",
    "duration": 30
  },
  "message": "Request Successful!",
  "success": true
}

Alquiler Plus

Alquila por meses un número de un país para recibir los mensajes de todos los servicios, renuévalo o deja que se renueve solo.

Listar países

Muestra los países en los que Alquiler Plus vende números, con sus códigos.

GET/s6-rental-countries
Ejemplo de solicitud
curl "https://textverification.io/api/v1/users/s6-rental-countries" \
  -H "Authorization: Bearer YOUR_API_KEY"
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": [
    {
      "code": "ca",
      "name": "Canada"
    },
    {
      "code": "us",
      "name": "United States"
    }
  ],
  "message": "Request Successful!",
  "success": true
}

Listar periodos de alquiler y precios

Lista los periodos por los que se alquilan los números de Alquiler Plus en un país, con tu precio para cada uno.

GET/s6-rental-plans
ParámetroTipoObligatorioDescripción
countrystringNoUn código de país de la lista de países. Omítelo para EE. UU. (o para el primer país a la venta).
Ejemplo de solicitud
curl "https://textverification.io/api/v1/users/s6-rental-plans?country=us" \
  -H "Authorization: Bearer YOUR_API_KEY"
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": {
    "country": {
      "code": "us",
      "name": "United States"
    },
    "plans": [
      {
        "period": "1m",
        "months": 1,
        "days": 30,
        "price": "7.50"
      },
      {
        "period": "3m",
        "months": 3,
        "days": 90,
        "price": "21.00"
      }
    ]
  },
  "message": "Request Successful!",
  "success": true
}

Alquilar un número

Alquila un número de Alquiler Plus para un servicio y cobra de tu saldo el periodo completo.

POST/request-s6-rental
ParámetroTipoObligatorioDescripción
periodstringSíEl periodo de alquiler en meses, de la lista de periodos: "1m", "2m", "3m", "6m" o "12m".
autoRenewbooleanNotrue para renovar el alquiler con tu saldo unas horas antes de que termine.
countrystringNoUn código de país de la lista de países. Omítelo para EE. UU. (o para el primer país a la venta).

Un número de Alquiler Plus no está ligado a un servicio: recibe los mensajes de todos. Se puede cancelar con reembolso en los 20 minutos siguientes al alquiler, antes de su primer mensaje.

Ejemplo de solicitud
curl -X POST "https://textverification.io/api/v1/users/request-s6-rental" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"period":"1m","country":"us","autoRenew":true}'
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": {
    "orderId": "9c41e2b7",
    "number": "15143080170",
    "serviceName": "Any service",
    "anyService": true,
    "country": "United States",
    "period": "1m",
    "months": 1,
    "duration": 30,
    "price": "7.50",
    "status": "reserved",
    "canRefund": true,
    "autoRenew": true,
    "purchased": "2026-10-09 12:44:00",
    "expires": "2026-11-08 12:44:00",
    "remainingTime": 2591940
  },
  "message": "Request Successful!",
  "success": true
}

Consultar un alquiler

Devuelve un alquiler con su estado, su fecha de finalización y su configuración de renovación.

GET/s6-rental-details
ParámetroTipoObligatorioDescripción
orderIdstringSíEl ID del pedido, tal como se devolvió al hacer el pedido.
Ejemplo de solicitud
curl "https://textverification.io/api/v1/users/s6-rental-details?orderId=9c41e2b7" \
  -H "Authorization: Bearer YOUR_API_KEY"
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": {
    "orderId": "9c41e2b7",
    "number": "15143080170",
    "serviceName": "Any service",
    "anyService": true,
    "country": "United States",
    "period": "1m",
    "months": 1,
    "duration": 30,
    "price": "7.50",
    "status": "active",
    "canRefund": false,
    "autoRenew": true,
    "purchased": "2026-10-09 12:44:00",
    "expires": "2026-11-08 12:44:00",
    "remainingTime": 2591940
  },
  "message": "Request Successful!",
  "success": true
}

Leer los mensajes de un alquiler

Devuelve los mensajes que ha recibido un alquiler, del más reciente al más antiguo.

GET/s6-rental-messages
ParámetroTipoObligatorioDescripción
orderIdstringSíEl ID del pedido, tal como se devolvió al hacer el pedido.
page / limitnumberNoNúmero de página y tamaño de página (hasta 100).
Ejemplo de solicitud
curl "https://textverification.io/api/v1/users/s6-rental-messages?orderId=9c41e2b7" \
  -H "Authorization: Bearer YOUR_API_KEY"
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": {
    "messages": [
      {
        "id": "66f0a1",
        "orderId": "9c41e2b7",
        "number": "15143080170",
        "service": "Any service",
        "sender": "",
        "message": "Your WhatsApp code: 551-204",
        "pin": "551204",
        "timestamp": "2026-10-09 12:44:00"
      }
    ],
    "pagination": {
      "total": 1,
      "page": 1,
      "limit": 10,
      "totalPages": 1
    }
  },
  "message": "Request Successful!",
  "success": true
}

Consultar precios de renovación

Muestra los periodos por los que se puede renovar un alquiler activo, con tu precio para cada uno.

GET/s6-rental-renew-options
ParámetroTipoObligatorioDescripción
orderIdstringSíEl ID del pedido, tal como se devolvió al hacer el pedido.
Ejemplo de solicitud
curl "https://textverification.io/api/v1/users/s6-rental-renew-options?orderId=9c41e2b7" \
  -H "Authorization: Bearer YOUR_API_KEY"
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": {
    "orderId": "9c41e2b7",
    "number": "15143080170",
    "serviceName": "Any service",
    "anyService": true,
    "periods": [
      {
        "period": "1m",
        "months": 1,
        "days": 30,
        "price": "7.50"
      },
      {
        "period": "3m",
        "months": 3,
        "days": 90,
        "price": "21.00"
      }
    ]
  },
  "message": "Request Successful!",
  "success": true
}

Renovar un alquiler

Amplía un alquiler activo y lo cobra de tu saldo. Si no indicas un periodo, se renueva por su misma duración.

POST/renew-s6-rental
ParámetroTipoObligatorioDescripción
orderIdstringSíEl ID del pedido, tal como se devolvió al hacer el pedido.
periodstringNoEl periodo de renovación, de los precios de renovación, como "1m". Omítelo para renovar por el periodo del propio alquiler.
Ejemplo de solicitud
curl -X POST "https://textverification.io/api/v1/users/renew-s6-rental" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"9c41e2b7","period":"3m"}'
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": {
    "orderId": "9c41e2b7",
    "number": "15143080170",
    "serviceName": "Any service",
    "anyService": true,
    "country": "United States",
    "period": "1m",
    "months": 1,
    "duration": 30,
    "price": "28.50",
    "status": "reserved",
    "canRefund": false,
    "autoRenew": true,
    "purchased": "2026-10-09 12:44:00",
    "expires": "2027-02-09 12:44:00",
    "remainingTime": 2591940
  },
  "message": "Request Successful!",
  "success": true
}

Activar o desactivar la renovación automática

Define si un alquiler activo se renueva con tu saldo unas horas antes de que termine.

POST/s6-rental-auto-renew
ParámetroTipoObligatorioDescripción
orderIdstringSíEl ID del pedido, tal como se devolvió al hacer el pedido.
enabledbooleanSítrue para activar la renovación automática, false para desactivarla.
Ejemplo de solicitud
curl -X POST "https://textverification.io/api/v1/users/s6-rental-auto-renew" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"9c41e2b7","enabled":true}'
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": {
    "orderId": "9c41e2b7",
    "autoRenew": true
  },
  "message": "Request Successful!",
  "success": true
}

Cancelar un alquiler

Cancela un alquiler que todavía se puede reembolsar (antes de su primer mensaje) y reembolsa el importe a tu saldo.

POST/cancel-s6-rental
ParámetroTipoObligatorioDescripción
orderIdstringSíEl ID del pedido, tal como se devolvió al hacer el pedido.
Ejemplo de solicitud
curl -X POST "https://textverification.io/api/v1/users/cancel-s6-rental" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"9c41e2b7"}'
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": null,
  "message": "Request Successful!",
  "success": true
}

Consultar precios de reactivación

Muestra los periodos por los que se puede reactivar el número de un alquiler expirado, con tu precio para cada uno.

GET/s6-rental-retake-options
ParámetroTipoObligatorioDescripción
orderIdstringSíEl ID del pedido, tal como se devolvió al hacer el pedido.
Ejemplo de solicitud
curl "https://textverification.io/api/v1/users/s6-rental-retake-options?orderId=9c41e2b7" \
  -H "Authorization: Bearer YOUR_API_KEY"
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": {
    "orderId": "9c41e2b7",
    "number": "15143080170",
    "serviceName": "Any service",
    "anyService": true,
    "periods": [
      {
        "period": "1m",
        "months": 1,
        "days": 30,
        "price": "7.50"
      }
    ]
  },
  "message": "Request Successful!",
  "success": true
}

Reactivar un número expirado

Vuelve a alquilar el número de un alquiler expirado para el mismo servicio, mientras siga libre.

POST/retake-s6-rental
ParámetroTipoObligatorioDescripción
orderIdstringSíEl ID del pedido, tal como se devolvió al hacer el pedido.
periodstringSíEl periodo de alquiler en meses, de la lista de periodos: "1m", "2m", "3m", "6m" o "12m".
autoRenewbooleanNotrue para renovar el alquiler con tu saldo unas horas antes de que termine.

Reactivar renueva el mismo alquiler, con el mismo orderId y número. Es posible durante unos días después de que termine el alquiler.

Ejemplo de solicitud
curl -X POST "https://textverification.io/api/v1/users/retake-s6-rental" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"9c41e2b7","period":"1m"}'
Ejemplo de respuesta
{
  "statusCode": 200,
  "data": {
    "orderId": "9c41e2b7",
    "number": "15143080170",
    "serviceName": "Any service",
    "anyService": true,
    "country": "United States",
    "period": "1m",
    "months": 1,
    "duration": 30,
    "price": "15.00",
    "status": "reserved",
    "canRefund": false,
    "autoRenew": true,
    "purchased": "2026-10-09 12:44:00",
    "expires": "2026-11-08 12:44:00",
    "remainingTime": 2591940
  },
  "message": "Request Successful!",
  "success": true
}

Callbacks

Configura una URL de callback en la configuración de tu cuenta. Cada vez que llega un código o un mensaje de un alquiler, lo enviamos a esa URL en una solicitud HTTP POST cuyo cuerpo JSON contiene event y data.

  • Responde con un estado 2xx en menos de 5 segundos para confirmar que lo recibiste.
  • Si tu servidor no responde a tiempo o devuelve otro estado, lo reintentamos a los 2 segundos y luego a los 4 segundos: 3 intentos en total.
  • El mismo evento puede llegar más de una vez: usa orderId para ignorar los repetidos.

Eventos

EventoSe envía cuando
s1_otp_receivedUn número de Prime recibe su código.
s1_win_premium_requestUna solicitud premium de Prime obtiene un número.
s2_otp_receivedUn número de Pinpoint recibe su código.
s3_otp_receivedUn número de Flex recibe su código.
s4_otp_receivedUn número de Global recibe su código.
s5_otp_receivedUn número de Smart recibe su código.
s6_otp_receivedUn número de Plus recibe su código.
s7_otp_receivedUn número de Express recibe su código.
rental_otp_receivedUn número de Alquiler Pinpoint recibe un mensaje.
s3_rental_otp_receivedUn número de Alquiler Flex recibe un mensaje.
s4_rental_otp_receivedUn número de Alquiler Global recibe un mensaje.
s6_rental_otp_receivedUn número de Alquiler Plus recibe un mensaje.

Carga útil

data.orderId
El pedido al que pertenece el código.
data.timestamp
Cuándo lo recibimos (UTC).
data.number
El número de teléfono que lo recibió.
data.service
El servicio para el que se pidió el número.
data.message
El mensaje completo.
data.otp
El código encontrado en el mensaje.
Ejemplo de callback
{
  "event": "s2_otp_received",
  "data": {
    "orderId": "lr_01K7ABC",
    "timestamp": "2026-10-09 12:44:00",
    "number": "12125550102",
    "service": "google",
    "message": "G-482910 is your Google verification code.",
    "otp": "482910"
  }
}

¿Tienes problemas con una integración? Contacta con nuestro equipo.