Pular para o conteúdo
Logo do siteTextVerification
Desenvolvedores

Documentação da API

Peça números, leia códigos e gerencie aluguéis direto do seu código. A API usa o mesmo saldo e os mesmos preços do seu painel, em todos os produtos.

  • REST e JSON via HTTPS
  • Chave de API (token Bearer)
  • Callbacks com novas tentativas
  • 100 requisições por minuto
  • Os mesmos preços do seu painel

Primeiros passos

Tudo o que você precisa antes da primeira requisição: o endereço, a autenticação, o formato das respostas e os erros que podem aparecer.

URL base

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

Autenticação

Envie sua chave de API como token Bearer: Authorization: Bearer YOUR_API_KEY. Gere uma chave nas configurações da conta e mantenha-a no seu servidor: qualquer pessoa com ela pode gastar seu saldo.

Requisições e respostas

Envie o corpo das requisições em JSON (campos de formulário também funcionam). Toda resposta é um JSON com statusCode, success, message e data; os preços são em dólares americanos, como strings com duas casas decimais.

Início rápido

Peça um número Pinpoint e leia o código. Todos os outros produtos funcionam do mesmo jeito.

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"])

Erros

StatusDescrição
400A requisição é inválida ou seu saldo não cobre o pedido.
401A chave de API está ausente, é inválida ou está inativa.
403Não permitido no momento, por exemplo, por excesso de pedidos em aberto ou conta restrita.
404O pedido ou serviço não existe ou não é seu.
409O pedido não pode mais ser alterado (já foi concluído ou cancelado), ou o preço acabou de mudar.
422Uma opção é inválida, como um código de área ou período de aluguel desconhecido.
429Requisições demais: diminua o ritmo e tente novamente em instantes.
503O produto não está disponível no momento. Tente novamente mais tarde ou use outro produto.

Prefira callbacks a polling: eles avisam seu servidor assim que um código chega. Se precisar consultar um pedido repetidamente, espere alguns segundos entre as requisições.

Limites de requisições

Cada endereço IP pode fazer até 100 requisições por minuto, e cada chave de API até 600 por minuto somando todos os endereços. Toda resposta traz os cabeçalhos RateLimit-Remaining e RateLimit-Reset. Uma requisição acima do limite recebe um 429 com um cabeçalho Retry-After informando quantos segundos esperar. Com callbacks, você fica bem abaixo desse limite.

Mantenha sua integração segura

  • Mantenha sua chave de API no seu servidor: nunca em um app móvel, no código do navegador ou em um repositório público.
  • Se uma chave puder ter vazado, gere uma nova nas configurações da conta. A chave antiga para de funcionar na hora.
  • As URLs de callback devem usar HTTPS. Adicione ao caminho um token difícil de adivinhar e, antes de agir, confira se cada orderId pertence a um pedido que você fez.
  • Sua chave gasta o seu saldo: consulte-o com o endpoint de saldo e recarregue antes de grandes lotes.

Consultar seu saldo

Retorna o saldo da sua conta em dólares americanos.

GET/balance
Exemplo de requisição
curl "https://textverification.io/api/v1/users/balance" \
  -H "Authorization: Bearer YOUR_API_KEY"
Exemplo de resposta
{
  "statusCode": 200,
  "data": "120.50",
  "message": "Request Successful!",
  "success": true
}

Prime

Números dos EUA com escolha de estado e solicitações premium para serviços esgotados.

Listar serviços e preços

Lista os serviços do Prime com o seu preço para cada um, já com o seu desconto.

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

Consultar o preço de um serviço com opções

Retorna o seu preço para um serviço com as opções que você usaria no pedido.

GET/server1-price
ParâmetroTipoObrigatórioDescrição
serviceIdstringSimO ID do serviço, da lista de serviços.
areaCodestringNãoUm código de área dos EUA de 3 dígitos, como "212", para obter um número dessa área. Ele tem prioridade sobre o estado e pode aumentar o preço.
requestPremiumnumberNãoUm lance premium para serviços esgotados: o pedido fica pendente e ganha um número quando houver um disponível.
Exemplo de requisição
curl "https://textverification.io/api/v1/users/server1-price?serviceId=2264119e&areaCode=212&requestPremium=20" \
  -H "Authorization: Bearer YOUR_API_KEY"
Exemplo de resposta
{
  "statusCode": 200,
  "data": {
    "serviceId": "2264119e",
    "serviceName": "WhatsApp",
    "areaCode": "212",
    "requestPremium": 20,
    "price": "1.56"
  },
  "message": "Request Successful!",
  "success": true
}

Listar estados dos EUA

Lista os estados dos EUA que você pode solicitar.

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

Pedir um número

Pede um número do Prime para um serviço e cobra do seu saldo.

POST/request-s1-service
ParâmetroTipoObrigatórioDescrição
serviceIdstringSimO ID do serviço, da lista de serviços.
statestringNãoUm código de estado dos EUA, como "NY", para obter um número desse estado.
areaCodestringNãoUm código de área dos EUA de 3 dígitos, como "212", para obter um número dessa área. Ele tem prioridade sobre o estado e pode aumentar o preço.
requestPremiumnumberNãoUm lance premium para serviços esgotados: o pedido fica pendente e ganha um número quando houver um disponível.

Com um lance premium, o pedido de um serviço esgotado fica pendente; você recebe um callback s1_win_premium_request quando ele ganha um número.

Exemplo de requisição
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"}'
Exemplo de resposta
{
  "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 um pedido

Retorna um pedido com o status e, quando tiver chegado, o código.

GET/number-details-s1
ParâmetroTipoObrigatórioDescrição
orderIdstringSimO ID do pedido, conforme retornado ao fazer o pedido.
Exemplo de requisição
curl "https://textverification.io/api/v1/users/number-details-s1?orderId=55655059" \
  -H "Authorization: Bearer YOUR_API_KEY"
Exemplo de resposta
{
  "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 um número

Pede o mesmo número de novo para outro código, quando o serviço permite.

POST/reuse-s1-service
ParâmetroTipoObrigatórioDescrição
orderIdstringSimO ID do pedido, conforme retornado ao fazer o pedido.
Exemplo de requisição
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"}'
Exemplo de resposta
{
  "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 um número

Cancela um número que ainda não recebeu código e reembolsa o valor no seu saldo.

POST/reject-s1-service
ParâmetroTipoObrigatórioDescrição
orderIdstringSimO ID do pedido, conforme retornado ao fazer o pedido.
Exemplo de requisição
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"}'
Exemplo de resposta
{
  "statusCode": 200,
  "data": null,
  "message": "Request Successful!",
  "success": true
}

Pinpoint

Números dos EUA com os códigos de área e as operadoras que você escolher, e o código por SMS ou, quando disponível, por chamada de voz.

Listar serviços e preços

Lista os serviços do Pinpoint com o seu preço para cada um, já com o seu desconto.

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

Consultar o preço de um serviço com opções

Retorna o seu preço para um serviço com as opções que você usaria no pedido.

GET/server2-price
ParâmetroTipoObrigatórioDescrição
serviceIdstringSimO ID do serviço, da lista de serviços.
areasstringNãoCódigos de área para escolher, separados por vírgulas (até 10), por exemplo, "212,646". Aumentam o preço.
carrierstringNãoOperadoras para escolher, separadas por vírgulas: tmo (T-Mobile), vz (Verizon), att (AT&T). Aumentam o preço.
capabilitystringNão"sms" (padrão) ou "voice" para receber o código por chamada, quando houver chamadas de voz.
Exemplo de requisição
curl "https://textverification.io/api/v1/users/server2-price?serviceId=1fe58df2&areas=212%2C646&carrier=vz" \
  -H "Authorization: Bearer YOUR_API_KEY"
Exemplo de resposta
{
  "statusCode": 200,
  "data": {
    "serviceName": "google",
    "price": "1.53",
    "capability": "sms",
    "areaCode": true,
    "carrier": true
  },
  "message": "Request Successful!",
  "success": true
}

Listar códigos de área

Lista os códigos de área dos EUA que você pode solicitar, com seus estados.

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

Pedir um número

Pede um número do Pinpoint para um serviço e cobra do seu saldo.

POST/request-s2-service
ParâmetroTipoObrigatórioDescrição
serviceIdstringSimO ID do serviço, da lista de serviços.
areasstringNãoCódigos de área para escolher, separados por vírgulas (até 10), por exemplo, "212,646". Aumentam o preço.
carrierstringNãoOperadoras para escolher, separadas por vírgulas: tmo (T-Mobile), vz (Verizon), att (AT&T). Aumentam o preço.
capabilitystringNão"sms" (padrão) ou "voice" para receber o código por chamada, quando houver chamadas de voz.

Pedidos de voz (capability "voice") são atendidos com o Voice SDK da Twilio e o token do endpoint de token de voz. O pedido é concluído quando a chamada chega, e os detalhes dele listam a chamada.

Exemplo de requisição
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"}'
Exemplo de resposta
{
  "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 um pedido

Retorna um pedido com o status e, quando tiver chegado, o código.

GET/number-details-s2
ParâmetroTipoObrigatórioDescrição
orderIdstringSimO ID do pedido, conforme retornado ao fazer o pedido.
Exemplo de requisição
curl "https://textverification.io/api/v1/users/number-details-s2?orderId=lr_01K7ABC" \
  -H "Authorization: Bearer YOUR_API_KEY"
Exemplo de resposta
{
  "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 um número

Pede o mesmo número de novo para outro código, quando o serviço permite.

POST/reuse-s2-service
ParâmetroTipoObrigatórioDescrição
orderIdstringSimO ID do pedido, conforme retornado ao fazer o pedido.
Exemplo de requisição
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"}'
Exemplo de resposta
{
  "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 um número

Cancela um número que ainda não recebeu código e reembolsa o valor no seu saldo.

POST/reject-s2-service
ParâmetroTipoObrigatórioDescrição
orderIdstringSimO ID do pedido, conforme retornado ao fazer o pedido.
Exemplo de requisição
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"}'
Exemplo de resposta
{
  "statusCode": 200,
  "data": null,
  "message": "Request Successful!",
  "success": true
}

Obter um token de chamada de voz

Retorna um token de curta duração para atender a chamada de um pedido de voz com o Voice SDK da Twilio.

GET/s2-voice-token
ParâmetroTipoObrigatórioDescrição
orderIdstringSimO ID do pedido, conforme retornado ao fazer o pedido.
Exemplo de requisição
curl "https://textverification.io/api/v1/users/s2-voice-token?orderId=lr_01K7ABC" \
  -H "Authorization: Bearer YOUR_API_KEY"
Exemplo de resposta
{
  "statusCode": 200,
  "data": {
    "orderId": "lr_01K7ABC",
    "token": "eyJhbGciOi…",
    "expiresIn": 540
  },
  "message": "Request Successful!",
  "success": true
}

Baixar a gravação de uma chamada

Retorna a gravação da chamada de um pedido de voz, quando houver uma.

GET/s2-voice-recording
ParâmetroTipoObrigatórioDescrição
orderIdstringSimO ID do pedido, conforme retornado ao fazer o pedido.
callIdstringSimO ID da chamada, da lista de chamadas do pedido.
Exemplo de requisição
curl "https://textverification.io/api/v1/users/s2-voice-recording?orderId=lr_01K7ABC&callId=call_8f2" \
  -H "Authorization: Bearer YOUR_API_KEY"
Exemplo de resposta
(audio file)

Flex

Vários códigos de área e uma operadora em um só pedido, nos EUA e em outros países disponíveis.

Listar serviços e preços

Lista os serviços do Flex com o seu preço para cada um, já com o seu desconto.

GET/server3-pricing
ParâmetroTipoObrigatórioDescrição
countrystringNãoUm código de país da lista de países. Omita para os EUA (ou para o primeiro país à venda).
Exemplo de requisição
curl "https://textverification.io/api/v1/users/server3-pricing" \
  -H "Authorization: Bearer YOUR_API_KEY"
Exemplo de resposta
{
  "statusCode": 200,
  "data": [
    {
      "serviceId": "9a1c55e0",
      "serviceName": "Telegram",
      "price": "0.40"
    }
  ],
  "message": "Request Successful!",
  "success": true
}

Listar países

Lista os países em que o Flex vende números, com seus códigos.

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

Pedir um número

Pede um número do Flex para um serviço e cobra do seu saldo.

POST/request-s3-service
ParâmetroTipoObrigatórioDescrição
serviceIdstringSimO ID do serviço, da lista de serviços.
areasstringNãoCódigos de área, separados por vírgulas (até 10). Aumentam o preço.
carrierstringNão"att" ou "tmo". Aumenta o preço.
countrystringNãoUm código de país da lista de países. Omita para os EUA (ou para o primeiro país à venda).
Exemplo de requisição
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"}'
Exemplo de resposta
{
  "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 um pedido

Retorna um pedido com o status e, quando tiver chegado, o código.

GET/number-details-s3
ParâmetroTipoObrigatórioDescrição
orderIdstringSimO ID do pedido, conforme retornado ao fazer o pedido.
Exemplo de requisição
curl "https://textverification.io/api/v1/users/number-details-s3?orderId=48211973" \
  -H "Authorization: Bearer YOUR_API_KEY"
Exemplo de resposta
{
  "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 um número

Pede o mesmo número de novo para outro código, quando o serviço permite.

POST/reuse-s3-service
ParâmetroTipoObrigatórioDescrição
orderIdstringSimO ID do pedido, conforme retornado ao fazer o pedido.
Exemplo de requisição
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"}'
Exemplo de resposta
{
  "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 um número

Cancela um número que ainda não recebeu código e reembolsa o valor no seu saldo.

POST/reject-s3-service
ParâmetroTipoObrigatórioDescrição
orderIdstringSimO ID do pedido, conforme retornado ao fazer o pedido.
Exemplo de requisição
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"}'
Exemplo de resposta
{
  "statusCode": 200,
  "data": null,
  "message": "Request Successful!",
  "success": true
}

Global

Números de vários países: liste os países e depois peça um número para um serviço em um deles.

Listar serviços e preços

Lista os serviços do Global com o seu preço para cada um, já com o seu desconto.

GET/server4-pricing
ParâmetroTipoObrigatórioDescrição
countrystringNãoUm código de país da lista de países. Omita para os EUA (ou para o primeiro país à venda).
Exemplo de requisição
curl "https://textverification.io/api/v1/users/server4-pricing?country=gb" \
  -H "Authorization: Bearer YOUR_API_KEY"
Exemplo de resposta
{
  "statusCode": 200,
  "data": [
    {
      "serviceId": "c41e7a02",
      "serviceName": "WhatsApp",
      "price": "0.35"
    }
  ],
  "message": "Request Successful!",
  "success": true
}

Listar países

Lista os países em que o Global vende números, com seus códigos.

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

Obter opções de verificação e operadora

Informa se um serviço pode ser verificado por FlashCall + SMS em um país e as operadoras de onde os números podem vir, com o preço de cada opção.

GET/server4-options
ParâmetroTipoObrigatórioDescrição
serviceIdstringSimO ID do serviço, da lista de serviços.
countrystringNãoUm código de país da lista de países. Omita para os EUA (ou para o primeiro país à venda).
Exemplo de requisição
curl "https://textverification.io/api/v1/users/server4-options?serviceId=c41e7a02&country=us" \
  -H "Authorization: Bearer YOUR_API_KEY"
Exemplo de resposta
{
  "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 um número

Pede um número do Global para um serviço e cobra do seu saldo.

POST/request-s4-service
ParâmetroTipoObrigatórioDescrição
serviceIdstringSimO ID do serviço, da lista de serviços.
countrystringNãoUm código de país da lista de países. Omita para os EUA (ou para o primeiro país à venda).
verificationstringNão"call" para FlashCall + SMS: o serviço liga para o número e o número que liga é o código. "sms" por padrão.
operatorstringNãoO código de uma operadora do endpoint de opções, para receber um número apenas dessa operadora. Adiciona a taxa de operadora. Qualquer operadora por padrão.
Exemplo de requisição
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"}'
Exemplo de resposta
{
  "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 um pedido

Retorna um pedido com o status e, quando tiver chegado, o código.

GET/number-details-s4
ParâmetroTipoObrigatórioDescrição
orderIdstringSimO ID do pedido, conforme retornado ao fazer o pedido.
Exemplo de requisição
curl "https://textverification.io/api/v1/users/number-details-s4?orderId=3311842" \
  -H "Authorization: Bearer YOUR_API_KEY"
Exemplo de resposta
{
  "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 um número

Pede o mesmo número de novo para outro código, quando o serviço permite.

POST/reuse-s4-service
ParâmetroTipoObrigatórioDescrição
orderIdstringSimO ID do pedido, conforme retornado ao fazer o pedido.
Exemplo de requisição
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"}'
Exemplo de resposta
{
  "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 um número

Cancela um número que ainda não recebeu código e reembolsa o valor no seu saldo.

POST/reject-s4-service
ParâmetroTipoObrigatórioDescrição
orderIdstringSimO ID do pedido, conforme retornado ao fazer o pedido.
Exemplo de requisição
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"}'
Exemplo de resposta
{
  "statusCode": 200,
  "data": null,
  "message": "Request Successful!",
  "success": true
}

Smart

Números econômicos de vários países, com códigos de área, prioridade e até 5 números por requisição.

Listar serviços e preços

Lista os serviços do Smart com o seu preço para cada um, já com o seu desconto.

GET/server5-pricing
ParâmetroTipoObrigatórioDescrição
countrystringNãoUm código de país da lista de países. Omita para os EUA (ou para o primeiro país à venda).
Exemplo de requisição
curl "https://textverification.io/api/v1/users/server5-pricing" \
  -H "Authorization: Bearer YOUR_API_KEY"
Exemplo de resposta
{
  "statusCode": 200,
  "data": [
    {
      "serviceId": "7d0f3b11",
      "serviceName": "Telegram",
      "price": "0.12"
    }
  ],
  "message": "Request Successful!",
  "success": true
}

Listar países

Lista os países em que o Smart vende números, com seus códigos.

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

Obter opções de pedido

Retorna os códigos de área disponíveis para um serviço em um país e quanto eles acrescentam ao preço.

GET/server5-options
ParâmetroTipoObrigatórioDescrição
serviceIdstringSimO ID do serviço, da lista de serviços.
countrystringNãoUm código de país da lista de países. Omita para os EUA (ou para o primeiro país à venda).
Exemplo de requisição
curl "https://textverification.io/api/v1/users/server5-options?serviceId=7d0f3b11&country=us" \
  -H "Authorization: Bearer YOUR_API_KEY"
Exemplo de resposta
{
  "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 um número

Pede um número do Smart para um serviço e cobra do seu saldo.

POST/request-s5-service
ParâmetroTipoObrigatórioDescrição
serviceIdstringSimO ID do serviço, da lista de serviços.
countrystringNãoUm código de país da lista de países. Omita para os EUA (ou para o primeiro país à venda).
areaCodesstring[]NãoCódigos de área que você quer receber, ou evitar com excludeAreaCodes: em lista ou separados por vírgulas, até 10. Aumentam o preço.
excludeAreaCodesbooleanNãotrue para evitar esses códigos de área em vez de receber um deles.
prioritystringNão"price" (padrão) para o menor preço ou "success" para a linha com mais chances de entregar seu código.
quantitynumberNãoQuantos números pedir de uma vez, de 1 a 5. Cada um vira um pedido separado.
phoneNumberstringNãoUm número específico que você já teve, em dígitos com o código do país, se estiver livre de novo.

Com uma quantidade maior que 1, a resposta lista todos os pedidos feitos; se menos números puderem ser pedidos, ela informa quantos e por quê.

Exemplo de requisição
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"}'
Exemplo de resposta
{
  "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 um pedido

Retorna um pedido com o status e, quando tiver chegado, o código.

GET/number-details-s5
ParâmetroTipoObrigatórioDescrição
orderIdstringSimO ID do pedido, conforme retornado ao fazer o pedido.
Exemplo de requisição
curl "https://textverification.io/api/v1/users/number-details-s5?orderId=AB12CD34" \
  -H "Authorization: Bearer YOUR_API_KEY"
Exemplo de resposta
{
  "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 um número

Pede o mesmo número de novo para outro código, quando o serviço permite.

POST/reuse-s5-service
ParâmetroTipoObrigatórioDescrição
orderIdstringSimO ID do pedido, conforme retornado ao fazer o pedido.
Exemplo de requisição
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"}'
Exemplo de resposta
{
  "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 um número

Cancela um número que ainda não recebeu código e reembolsa o valor no seu saldo.

POST/reject-s5-service
ParâmetroTipoObrigatórioDescrição
orderIdstringSimO ID do pedido, conforme retornado ao fazer o pedido.
Exemplo de requisição
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"}'
Exemplo de resposta
{
  "statusCode": 200,
  "data": null,
  "message": "Request Successful!",
  "success": true
}

Plus

Números de vários países, cada serviço em várias linhas: peça a mais barata, escolha uma linha ou limite quanto vai pagar.

Listar serviços e preços

Lista os serviços do Plus com o seu preço para cada um, já com o seu desconto.

GET/server6-pricing
ParâmetroTipoObrigatórioDescrição
countrystringNãoUm código de país da lista de países. Omita para os EUA (ou para o primeiro país à venda).
Exemplo de requisição
curl "https://textverification.io/api/v1/users/server6-pricing?country=us" \
  -H "Authorization: Bearer YOUR_API_KEY"
Exemplo de resposta
{
  "statusCode": 200,
  "data": [
    {
      "serviceId": "5b2c9e41",
      "serviceName": "WhatsApp",
      "price": "0.68"
    }
  ],
  "message": "Request Successful!",
  "success": true
}

Listar países

Lista os países em que o Plus vende números, com seus códigos.

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

Listar linhas e preços

Lista as linhas pelas quais um serviço é vendido em um país, da mais barata para a mais cara, com o seu preço em cada uma e a taxa de sucesso quando conhecida.

GET/server6-options
ParâmetroTipoObrigatórioDescrição
serviceIdstringSimO ID do serviço, da lista de serviços.
countrystringNãoUm código de país da lista de países. Omita para os EUA (ou para o primeiro país à venda).
Exemplo de requisição
curl "https://textverification.io/api/v1/users/server6-options?serviceId=5b2c9e41&country=us" \
  -H "Authorization: Bearer YOUR_API_KEY"
Exemplo de resposta
{
  "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 um número

Pede um número do Plus para um serviço e cobra do seu saldo.

POST/request-s6-service
ParâmetroTipoObrigatórioDescrição
serviceIdstringSimO ID do serviço, da lista de serviços.
countrystringNãoUm código de país da lista de países. Omita para os EUA (ou para o primeiro país à venda).
lineIdstringNãoUma linha da lista de linhas. Deixe de fora para usar a mais barata.
maxPricenumberNãoO máximo que você vai pagar, em dólares americanos. Um preço maior é recusado; sem lineId, qualquer linha até esse preço pode ser usada.

Sem lineId, é usada a linha mais barata, e outra linha pelo mesmo preço se ela não tiver números. Se uma linha não entregar códigos de um serviço, rejeite o número e peça por outra lineId.

Exemplo de requisição
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}'
Exemplo de resposta
{
  "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 um pedido

Retorna um pedido com o status e, quando tiver chegado, o código.

GET/number-details-s6
ParâmetroTipoObrigatórioDescrição
orderIdstringSimO ID do pedido, conforme retornado ao fazer o pedido.
Exemplo de requisição
curl "https://textverification.io/api/v1/users/number-details-s6?orderId=230698" \
  -H "Authorization: Bearer YOUR_API_KEY"
Exemplo de resposta
{
  "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 um número

Pede o mesmo número de novo para outro código, quando o serviço permite.

POST/reuse-s6-service
ParâmetroTipoObrigatórioDescrição
orderIdstringSimO ID do pedido, conforme retornado ao fazer o pedido.
Exemplo de requisição
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"}'
Exemplo de resposta
{
  "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 um número

Cancela um número que ainda não recebeu código e reembolsa o valor no seu saldo.

POST/reject-s6-service
ParâmetroTipoObrigatórioDescrição
orderIdstringSimO ID do pedido, conforme retornado ao fazer o pedido.
Exemplo de requisição
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"}'
Exemplo de resposta
{
  "statusCode": 200,
  "data": null,
  "message": "Request Successful!",
  "success": true
}

Express

Números dos EUA para um código rápido: faça o pedido para um serviço e receba o código nos detalhes do pedido ou por callback dentro dos 5 minutos do número.

Listar serviços e preços

Lista os serviços do Express com o seu preço para cada um, já com o seu desconto.

GET/server7-pricing
Exemplo de requisição
curl "https://textverification.io/api/v1/users/server7-pricing" \
  -H "Authorization: Bearer YOUR_API_KEY"
Exemplo de resposta
{
  "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 um número

Pede um número do Express para um serviço e cobra do seu saldo.

POST/request-s7-service
ParâmetroTipoObrigatórioDescrição
serviceIdstringSimO ID do serviço, da lista de serviços.
smsModestringNão"multiple" para receber cada SMS enviado ao número enquanto ele está ativo (5 minutos), entregue assim que chega, pelo multiplePrice do serviço. Só para serviços cujos smsModes incluem "multiple". "single" por padrão, ou "multiple" para um serviço vendido só dessa forma.

Um número Express fica ativo por 5 minutos. Se nenhum código chegar nesse tempo, o pedido é cancelado e reembolsado automaticamente. Números Express não podem ser reutilizados. Com smsMode "multiple", o número continua recebendo códigos durante os seus 5 minutos: cada código novo envia outro callback s7_otp_received, e os detalhes do pedido listam todos os códigos, o mais recente como pin.

Exemplo de requisição
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"}'
Exemplo de resposta
{
  "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 um pedido

Retorna um pedido com o status e, quando tiver chegado, o código.

GET/number-details-s7
ParâmetroTipoObrigatórioDescrição
orderIdstringSimO ID do pedido, conforme retornado ao fazer o pedido.
Exemplo de requisição
curl "https://textverification.io/api/v1/users/number-details-s7?orderId=9f2c41ab07d3e815" \
  -H "Authorization: Bearer YOUR_API_KEY"
Exemplo de resposta
{
  "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 um número

Cancela um número que ainda não recebeu código e reembolsa o valor no seu saldo.

POST/reject-s7-service
ParâmetroTipoObrigatórioDescrição
orderIdstringSimO ID do pedido, conforme retornado ao fazer o pedido.
Exemplo de requisição
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"}'
Exemplo de resposta
{
  "statusCode": 200,
  "data": null,
  "message": "Request Successful!",
  "success": true
}

Aluguel Pinpoint

Fique com um número dos EUA para um serviço de 1 dia a um ano, com renovações e renovação automática.

Listar serviços e preços de aluguel

Lista os serviços do Aluguel Pinpoint com o seu preço para cada período de aluguel.

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

Consultar o preço de um aluguel

Retorna o seu preço para cada período de aluguel de um serviço, com ou sem códigos de área.

GET/rental-prices
ParâmetroTipoObrigatórioDescrição
serviceIdstringSimO ID do serviço, da lista de serviços.
areasstringNãoCódigos de área, separados por vírgulas (até 10). Aumentam o preço.

Nem todo serviço oferece todos os períodos: este endpoint retorna os períodos pelos quais um serviço pode ser alugado.

Exemplo de requisição
curl "https://textverification.io/api/v1/users/rental-prices?serviceId=rg5e1d20" \
  -H "Authorization: Bearer YOUR_API_KEY"
Exemplo de resposta
{
  "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
}

Alugar um número

Aluga um número do Aluguel Pinpoint para um serviço e cobra do seu saldo o período inteiro.

POST/request-rental
ParâmetroTipoObrigatórioDescrição
serviceIdstringSimO ID do serviço, da lista de serviços.
durationstringSimA duração do aluguel: oneDay, threeDay, sevenDay, fourteenDay, thirtyDay, ninetyDay ou oneYear.
areasstringNãoCódigos de área, separados por vírgulas (até 10). Aumentam o preço.
autoRenewbooleanNãotrue para renovar o aluguel com seu saldo algumas horas antes de terminar.
Exemplo de requisição
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}'
Exemplo de resposta
{
  "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
}

Ler as mensagens de um aluguel

Retorna as mensagens recebidas por um aluguel, das mais recentes para as mais antigas.

GET/rental-messages
ParâmetroTipoObrigatórioDescrição
orderIdstringSimO ID do pedido, conforme retornado ao fazer o pedido.
page / limitnumberNãoNúmero da página e tamanho da página (até 100).
Exemplo de requisição
curl "https://textverification.io/api/v1/users/rental-messages?orderId=6702f1c4e2" \
  -H "Authorization: Bearer YOUR_API_KEY"
Exemplo de resposta
{
  "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 preços de renovação

Lista os períodos pelos quais um aluguel ativo pode ser renovado, com o seu preço para cada um.

GET/rental-renew-options
ParâmetroTipoObrigatórioDescrição
orderIdstringSimO ID do pedido, conforme retornado ao fazer o pedido.
Exemplo de requisição
curl "https://textverification.io/api/v1/users/rental-renew-options?orderId=6702f1c4e2" \
  -H "Authorization: Bearer YOUR_API_KEY"
Exemplo de resposta
{
  "statusCode": 200,
  "data": {
    "orderId": "6702f1c4e2",
    "number": "12125550104",
    "serviceName": "whatsapp",
    "periods": [
      {
        "period": "thirtyDay",
        "days": 30,
        "price": "7.20"
      }
    ]
  },
  "message": "Request Successful!",
  "success": true
}

Renovar um aluguel

Estende um aluguel ativo e cobra do seu saldo. Sem um período, ele é renovado pela mesma duração.

POST/renew-rental
ParâmetroTipoObrigatórioDescrição
orderIdstringSimO ID do pedido, conforme retornado ao fazer o pedido.
periodstringNãoO período de renovação (mesmos valores de duration). Omita para renovar pela mesma duração do aluguel.
Exemplo de requisição
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"}'
Exemplo de resposta
{
  "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
}

Ativar ou desativar a renovação automática

Define se um aluguel ativo é renovado com seu saldo algumas horas antes de terminar.

POST/rental-auto-renew
ParâmetroTipoObrigatórioDescrição
orderIdstringSimO ID do pedido, conforme retornado ao fazer o pedido.
enabledbooleanSimtrue para ativar a renovação automática, false para desativá-la.
Exemplo de requisição
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}'
Exemplo de resposta
{
  "statusCode": 200,
  "data": {
    "orderId": "6702f1c4e2",
    "autoRenew": false
  },
  "message": "Request Successful!",
  "success": true
}

Cancelar um aluguel

Cancela um aluguel que ainda pode ser reembolsado (antes da primeira mensagem) e devolve o valor ao seu saldo.

POST/release-rental
ParâmetroTipoObrigatórioDescrição
orderIdstringSimO ID do pedido, conforme retornado ao fazer o pedido.
Exemplo de requisição
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"}'
Exemplo de resposta
{
  "statusCode": 200,
  "data": null,
  "message": "Request Successful!",
  "success": true
}

Aluguel Flex

Fique com um número dos EUA por 1 a 30 dias, com renovação automática e reativação de números expirados.

Listar serviços e preços de aluguel

Lista os serviços do Aluguel Flex com o seu preço para cada período de aluguel.

GET/s3-rental-services
ParâmetroTipoObrigatórioDescrição
countrystringNãoUm código de país da lista de países. Omita para os EUA (ou para o primeiro país à venda).
Exemplo de requisição
curl "https://textverification.io/api/v1/users/s3-rental-services" \
  -H "Authorization: Bearer YOUR_API_KEY"
Exemplo de resposta
{
  "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

Lista os países em que o Aluguel Flex vende números, com seus códigos.

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

Alugar um número

Aluga um número do Aluguel Flex para um serviço e cobra do seu saldo o período inteiro.

POST/request-s3-rental
ParâmetroTipoObrigatórioDescrição
serviceIdstringSimO ID do serviço, da lista de serviços.
periodstringSimA duração do aluguel, da lista de serviços, como "7d".
areasstringNãoCódigos de área, separados por vírgulas (até 10). Aumentam o preço.
autoRenewbooleanNãotrue para renovar o aluguel com seu saldo algumas horas antes de terminar.
countrystringNãoUm código de país da lista de países. Omita para os EUA (ou para o primeiro país à venda).
Exemplo de requisição
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}'
Exemplo de resposta
{
  "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 um aluguel

Retorna um aluguel com o status, a data de término e as configurações de renovação.

GET/s3-rental-details
ParâmetroTipoObrigatórioDescrição
orderIdstringSimO ID do pedido, conforme retornado ao fazer o pedido.
Exemplo de requisição
curl "https://textverification.io/api/v1/users/s3-rental-details?orderId=6702f1c4e2" \
  -H "Authorization: Bearer YOUR_API_KEY"
Exemplo de resposta
{
  "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
}

Ler as mensagens de um aluguel

Retorna as mensagens recebidas por um aluguel, das mais recentes para as mais antigas.

GET/s3-rental-messages
ParâmetroTipoObrigatórioDescrição
orderIdstringSimO ID do pedido, conforme retornado ao fazer o pedido.
page / limitnumberNãoNúmero da página e tamanho da página (até 100).
Exemplo de requisição
curl "https://textverification.io/api/v1/users/s3-rental-messages?orderId=6702f1c4e2" \
  -H "Authorization: Bearer YOUR_API_KEY"
Exemplo de resposta
{
  "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 um aluguel

Estende um aluguel ativo e cobra do seu saldo. Sem um período, ele é renovado pela mesma duração.

POST/renew-s3-rental
ParâmetroTipoObrigatórioDescrição
orderIdstringSimO ID do pedido, conforme retornado ao fazer o pedido.
Exemplo de requisição
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"}'
Exemplo de resposta
{
  "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
}

Ativar ou desativar a renovação automática

Define se um aluguel ativo é renovado com seu saldo algumas horas antes de terminar.

POST/s3-rental-auto-renew
ParâmetroTipoObrigatórioDescrição
orderIdstringSimO ID do pedido, conforme retornado ao fazer o pedido.
enabledbooleanSimtrue para ativar a renovação automática, false para desativá-la.
Exemplo de requisição
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}'
Exemplo de resposta
{
  "statusCode": 200,
  "data": {
    "orderId": "6702f1c4e2",
    "autoRenew": true
  },
  "message": "Request Successful!",
  "success": true
}

Cancelar um aluguel

Cancela um aluguel que ainda pode ser reembolsado (antes da primeira mensagem) e devolve o valor ao seu saldo.

POST/cancel-s3-rental
ParâmetroTipoObrigatórioDescrição
orderIdstringSimO ID do pedido, conforme retornado ao fazer o pedido.
Exemplo de requisição
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"}'
Exemplo de resposta
{
  "statusCode": 200,
  "data": null,
  "message": "Request Successful!",
  "success": true
}

Consultar preços de reativação

Lista os períodos pelos quais o número de um aluguel expirado pode ser reativado, com o seu preço para cada um.

GET/s3-rental-retake-options
ParâmetroTipoObrigatórioDescrição
orderIdstringSimO ID do pedido, conforme retornado ao fazer o pedido.
Exemplo de requisição
curl "https://textverification.io/api/v1/users/s3-rental-retake-options?orderId=6702f1c4e2" \
  -H "Authorization: Bearer YOUR_API_KEY"
Exemplo de resposta
{
  "statusCode": 200,
  "data": {
    "orderId": "6702f1c4e2",
    "number": "12125550104",
    "serviceName": "Amazon",
    "periods": [
      {
        "period": "7d",
        "days": 7,
        "price": "4.80"
      }
    ]
  },
  "message": "Request Successful!",
  "success": true
}

Reativar um número expirado

Aluga de novo o número de um aluguel expirado para o mesmo serviço, enquanto ele ainda estiver livre.

POST/retake-s3-rental
ParâmetroTipoObrigatórioDescrição
orderIdstringSimO ID do pedido, conforme retornado ao fazer o pedido.
periodstringSimA duração do aluguel, da lista de serviços, como "7d".
autoRenewbooleanNãotrue para renovar o aluguel com seu saldo algumas horas antes de terminar.
Exemplo de requisição
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"}'
Exemplo de resposta
{
  "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
}

Aluguel Global

Alugue números em vários países, renove-os por qualquer período disponível ou deixe que se renovem automaticamente.

Listar serviços e preços de aluguel

Lista os serviços do Aluguel Global com o seu preço para cada período de aluguel.

GET/s4-rental-services
ParâmetroTipoObrigatórioDescrição
countrystringNãoUm código de país da lista de países. Omita para os EUA (ou para o primeiro país à venda).
Exemplo de requisição
curl "https://textverification.io/api/v1/users/s4-rental-services" \
  -H "Authorization: Bearer YOUR_API_KEY"
Exemplo de resposta
{
  "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

Lista os países em que o Aluguel Global vende números, com seus códigos.

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

Alugar um número

Aluga um número do Aluguel Global para um serviço e cobra do seu saldo o período inteiro.

POST/request-s4-rental
ParâmetroTipoObrigatórioDescrição
serviceIdstringSimO ID do serviço, da lista de serviços.
periodstringSimA duração do aluguel, da lista de serviços, como "7d".
autoRenewbooleanNãotrue para renovar o aluguel com seu saldo algumas horas antes de terminar.
countrystringNãoUm código de país da lista de países. Omita para os EUA (ou para o primeiro país à venda).
Exemplo de requisição
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"}'
Exemplo de resposta
{
  "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 um aluguel

Retorna um aluguel com o status, a data de término e as configurações de renovação.

GET/s4-rental-details
ParâmetroTipoObrigatórioDescrição
orderIdstringSimO ID do pedido, conforme retornado ao fazer o pedido.
Exemplo de requisição
curl "https://textverification.io/api/v1/users/s4-rental-details?orderId=6702f1c4e2" \
  -H "Authorization: Bearer YOUR_API_KEY"
Exemplo de resposta
{
  "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
}

Ler as mensagens de um aluguel

Retorna as mensagens recebidas por um aluguel, das mais recentes para as mais antigas.

GET/s4-rental-messages
ParâmetroTipoObrigatórioDescrição
orderIdstringSimO ID do pedido, conforme retornado ao fazer o pedido.
page / limitnumberNãoNúmero da página e tamanho da página (até 100).
Exemplo de requisição
curl "https://textverification.io/api/v1/users/s4-rental-messages?orderId=6702f1c4e2" \
  -H "Authorization: Bearer YOUR_API_KEY"
Exemplo de resposta
{
  "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 preços de renovação

Lista os períodos pelos quais um aluguel ativo pode ser renovado, com o seu preço para cada um.

GET/s4-rental-renew-options
ParâmetroTipoObrigatórioDescrição
orderIdstringSimO ID do pedido, conforme retornado ao fazer o pedido.
Exemplo de requisição
curl "https://textverification.io/api/v1/users/s4-rental-renew-options?orderId=6702f1c4e2" \
  -H "Authorization: Bearer YOUR_API_KEY"
Exemplo de resposta
{
  "statusCode": 200,
  "data": {
    "orderId": "6702f1c4e2",
    "number": "12125550104",
    "serviceName": "WhatsApp",
    "periods": [
      {
        "period": "30d",
        "days": 30,
        "price": "9.60"
      }
    ]
  },
  "message": "Request Successful!",
  "success": true
}

Renovar um aluguel

Estende um aluguel ativo e cobra do seu saldo. Sem um período, ele é renovado pela mesma duração.

POST/renew-s4-rental
ParâmetroTipoObrigatórioDescrição
orderIdstringSimO ID do pedido, conforme retornado ao fazer o pedido.
periodstringNãoO período de renovação, conforme os preços de renovação. Omita para renovar pela mesma duração do aluguel.
Exemplo de requisição
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"}'
Exemplo de resposta
{
  "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
}

Ativar ou desativar a renovação automática

Define se um aluguel ativo é renovado com seu saldo algumas horas antes de terminar.

POST/s4-rental-auto-renew
ParâmetroTipoObrigatórioDescrição
orderIdstringSimO ID do pedido, conforme retornado ao fazer o pedido.
enabledbooleanSimtrue para ativar a renovação automática, false para desativá-la.
Exemplo de requisição
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}'
Exemplo de resposta
{
  "statusCode": 200,
  "data": {
    "orderId": "6702f1c4e2",
    "autoRenew": true
  },
  "message": "Request Successful!",
  "success": true
}

Cancelar um aluguel

Cancela um aluguel que ainda pode ser reembolsado (antes da primeira mensagem) e devolve o valor ao seu saldo.

POST/cancel-s4-rental
ParâmetroTipoObrigatórioDescrição
orderIdstringSimO ID do pedido, conforme retornado ao fazer o pedido.
Exemplo de requisição
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"}'
Exemplo de resposta
{
  "statusCode": 200,
  "data": null,
  "message": "Request Successful!",
  "success": true
}

Consultar preços de reativação

Lista os períodos pelos quais o número de um aluguel expirado pode ser reativado, com o seu preço para cada um.

GET/s4-rental-retake-options
ParâmetroTipoObrigatórioDescrição
orderIdstringSimO ID do pedido, conforme retornado ao fazer o pedido.
Exemplo de requisição
curl "https://textverification.io/api/v1/users/s4-rental-retake-options?orderId=6702f1c4e2" \
  -H "Authorization: Bearer YOUR_API_KEY"
Exemplo de resposta
{
  "statusCode": 200,
  "data": {
    "orderId": "6702f1c4e2",
    "number": "12125550104",
    "serviceName": "WhatsApp",
    "periods": [
      {
        "period": "30d",
        "days": 30,
        "price": "9.60"
      }
    ]
  },
  "message": "Request Successful!",
  "success": true
}

Reativar um número expirado

Aluga de novo o número de um aluguel expirado para o mesmo serviço, enquanto ele ainda estiver livre.

POST/retake-s4-rental
ParâmetroTipoObrigatórioDescrição
orderIdstringSimO ID do pedido, conforme retornado ao fazer o pedido.
periodstringSimA duração do aluguel, da lista de serviços, como "7d".
autoRenewbooleanNãotrue para renovar o aluguel com seu saldo algumas horas antes de terminar.
Exemplo de requisição
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"}'
Exemplo de resposta
{
  "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
}

Aluguel Plus

Alugue por mês um número de um país para receber as mensagens de todos os serviços, renove-o ou deixe a renovação automática.

Listar países

Lista os países em que o Aluguel Plus vende números, com seus códigos.

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

Listar períodos de aluguel e preços

Lista os períodos pelos quais os números do Aluguel Plus são alugados em um país, com o seu preço para cada um.

GET/s6-rental-plans
ParâmetroTipoObrigatórioDescrição
countrystringNãoUm código de país da lista de países. Omita para os EUA (ou para o primeiro país à venda).
Exemplo de requisição
curl "https://textverification.io/api/v1/users/s6-rental-plans?country=us" \
  -H "Authorization: Bearer YOUR_API_KEY"
Exemplo de resposta
{
  "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
}

Alugar um número

Aluga um número do Aluguel Plus para um serviço e cobra do seu saldo o período inteiro.

POST/request-s6-rental
ParâmetroTipoObrigatórioDescrição
periodstringSimO período de aluguel em meses, da lista de períodos: "1m", "2m", "3m", "6m" ou "12m".
autoRenewbooleanNãotrue para renovar o aluguel com seu saldo algumas horas antes de terminar.
countrystringNãoUm código de país da lista de países. Omita para os EUA (ou para o primeiro país à venda).

Um número do Aluguel Plus não fica preso a um serviço: ele recebe as mensagens de todos. Pode ser cancelado com reembolso em até 20 minutos após alugar, antes da primeira mensagem.

Exemplo de requisição
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}'
Exemplo de resposta
{
  "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 um aluguel

Retorna um aluguel com o status, a data de término e as configurações de renovação.

GET/s6-rental-details
ParâmetroTipoObrigatórioDescrição
orderIdstringSimO ID do pedido, conforme retornado ao fazer o pedido.
Exemplo de requisição
curl "https://textverification.io/api/v1/users/s6-rental-details?orderId=9c41e2b7" \
  -H "Authorization: Bearer YOUR_API_KEY"
Exemplo de resposta
{
  "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
}

Ler as mensagens de um aluguel

Retorna as mensagens recebidas por um aluguel, das mais recentes para as mais antigas.

GET/s6-rental-messages
ParâmetroTipoObrigatórioDescrição
orderIdstringSimO ID do pedido, conforme retornado ao fazer o pedido.
page / limitnumberNãoNúmero da página e tamanho da página (até 100).
Exemplo de requisição
curl "https://textverification.io/api/v1/users/s6-rental-messages?orderId=9c41e2b7" \
  -H "Authorization: Bearer YOUR_API_KEY"
Exemplo de resposta
{
  "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 preços de renovação

Lista os períodos pelos quais um aluguel ativo pode ser renovado, com o seu preço para cada um.

GET/s6-rental-renew-options
ParâmetroTipoObrigatórioDescrição
orderIdstringSimO ID do pedido, conforme retornado ao fazer o pedido.
Exemplo de requisição
curl "https://textverification.io/api/v1/users/s6-rental-renew-options?orderId=9c41e2b7" \
  -H "Authorization: Bearer YOUR_API_KEY"
Exemplo de resposta
{
  "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 um aluguel

Estende um aluguel ativo e cobra do seu saldo. Sem um período, ele é renovado pela mesma duração.

POST/renew-s6-rental
ParâmetroTipoObrigatórioDescrição
orderIdstringSimO ID do pedido, conforme retornado ao fazer o pedido.
periodstringNãoO período de renovação, dos preços de renovação, como "1m". Deixe de fora para renovar pelo próprio período do aluguel.
Exemplo de requisição
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"}'
Exemplo de resposta
{
  "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
}

Ativar ou desativar a renovação automática

Define se um aluguel ativo é renovado com seu saldo algumas horas antes de terminar.

POST/s6-rental-auto-renew
ParâmetroTipoObrigatórioDescrição
orderIdstringSimO ID do pedido, conforme retornado ao fazer o pedido.
enabledbooleanSimtrue para ativar a renovação automática, false para desativá-la.
Exemplo de requisição
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}'
Exemplo de resposta
{
  "statusCode": 200,
  "data": {
    "orderId": "9c41e2b7",
    "autoRenew": true
  },
  "message": "Request Successful!",
  "success": true
}

Cancelar um aluguel

Cancela um aluguel que ainda pode ser reembolsado (antes da primeira mensagem) e devolve o valor ao seu saldo.

POST/cancel-s6-rental
ParâmetroTipoObrigatórioDescrição
orderIdstringSimO ID do pedido, conforme retornado ao fazer o pedido.
Exemplo de requisição
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"}'
Exemplo de resposta
{
  "statusCode": 200,
  "data": null,
  "message": "Request Successful!",
  "success": true
}

Consultar preços de reativação

Lista os períodos pelos quais o número de um aluguel expirado pode ser reativado, com o seu preço para cada um.

GET/s6-rental-retake-options
ParâmetroTipoObrigatórioDescrição
orderIdstringSimO ID do pedido, conforme retornado ao fazer o pedido.
Exemplo de requisição
curl "https://textverification.io/api/v1/users/s6-rental-retake-options?orderId=9c41e2b7" \
  -H "Authorization: Bearer YOUR_API_KEY"
Exemplo de resposta
{
  "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
}

Reativar um número expirado

Aluga de novo o número de um aluguel expirado para o mesmo serviço, enquanto ele ainda estiver livre.

POST/retake-s6-rental
ParâmetroTipoObrigatórioDescrição
orderIdstringSimO ID do pedido, conforme retornado ao fazer o pedido.
periodstringSimO período de aluguel em meses, da lista de períodos: "1m", "2m", "3m", "6m" ou "12m".
autoRenewbooleanNãotrue para renovar o aluguel com seu saldo algumas horas antes de terminar.

Reativar renova o mesmo aluguel, com o mesmo orderId e número. É possível por alguns dias depois que o aluguel termina.

Exemplo de requisição
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"}'
Exemplo de resposta
{
  "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

Defina uma URL de callback nas configurações da conta. Sempre que um código ou uma mensagem de aluguel chega, enviamos para essa URL em uma requisição HTTP POST cujo corpo JSON contém event e data.

  • Responda com um status 2xx em até 5 segundos para confirmar o recebimento.
  • Se o seu servidor não responder a tempo ou retornar outro status, tentamos de novo após 2 segundos e depois após 4 segundos: 3 tentativas no total.
  • O mesmo evento pode chegar mais de uma vez: use orderId para ignorar as repetições.

Eventos

EventoEnviado quando
s1_otp_receivedUm número do Prime recebe seu código.
s1_win_premium_requestUma solicitação premium do Prime ganha um número.
s2_otp_receivedUm número do Pinpoint recebe seu código.
s3_otp_receivedUm número do Flex recebe seu código.
s4_otp_receivedUm número do Global recebe seu código.
s5_otp_receivedUm número do Smart recebe seu código.
s6_otp_receivedUm número do Plus recebe seu código.
s7_otp_receivedUm número do Express recebe seu código.
rental_otp_receivedUm número do Aluguel Pinpoint recebe uma mensagem.
s3_rental_otp_receivedUm número do Aluguel Flex recebe uma mensagem.
s4_rental_otp_receivedUm número do Aluguel Global recebe uma mensagem.
s6_rental_otp_receivedUm número do Aluguel Plus recebe uma mensagem.

Payload

data.orderId
O pedido ao qual o código pertence.
data.timestamp
Quando o recebemos (UTC).
data.number
O número de telefone que o recebeu.
data.service
O serviço para o qual o número foi pedido.
data.message
A mensagem completa.
data.otp
O código encontrado na mensagem.
Exemplo 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"
  }
}

Travou em uma integração? Fale com a nossa equipe.