API

REST API para pedir números virtuais, consultar SMS, gerenciar aluguel de números e recarregar a carteira. Os mesmos endpoints que o dashboard usa — autenticação por bearer token, JSON entrada e saída, sem SDK necessário.

Autenticação

Gere um token API pessoal em Dashboard → Tokens API. Inclua-o como header bearer em toda requisição:

Authorization: Bearer <your-token>

URL base

https://smsactivator.io

Endpoints

  • GET/v1/servicesListe serviços suportados com preços atuais por país.
  • GET/v1/countriesListe países com estoque ativo.
  • POST/v1/ordersPeça um número virtual. Body: { serviceSlug, countryIso }. Retorna o número alocado e orderId.
  • GET/v1/orders/:idConsulte o status de recebimento do SMS. Retorna { status, sms, expiresAt }.
  • DELETE/v1/orders/:idCancele um pedido ativo. Reembolsa a carteira se nenhum SMS foi recebido.
  • POST/v1/paymentsCrie uma fatura de depósito cripto. Body: { provider, amountUsd, cryptoCurrency? }. Retorna o payLink da OxaPay.
  • GET/v1/walletObtenha o saldo atual da carteira e transações recentes.
  • GET/v1/rentalsListe aluguel de números ativos de longo prazo.

Início rápido

curl -X POST https://smsactivator.io/v1/orders \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"serviceSlug":"telegram","countryIso":"US"}'

Limites de taxa

  • Criar pedidos: 30 requisições / minuto / token
  • Consultar pedidos: 120 requisições / minuto / token
  • Pagamentos / depósitos: 10 requisições / hora / token
  • Fallback global por IP: 120 requisições / minuto (se aplica mesmo sem token)

Ao atingir um limite, retorna HTTP 429 com um header Retry-After.

Precisa de um limite maior?

Entre em contato @smsactivator_support com seu caso de uso. Planos reseller e integração ganham orçamento 10x maior em endpoints de pedidos.