smsmeu.
API para desenvolvedores

API de números para receber SMS

Integre verificação por SMS no seu produto em minutos. Compre números por chamada, descontando do mesmo saldo da sua conta. Entrega na hora, pague por uso, sem mensalidade.

Criar conta e gerar chave Ver documentação
Entrega na hora

O número é liberado na própria chamada de compra.

Mesmo saldo do painel

Recarregue uma vez e consuma por API. Sem cobrança por número.

Catálogo em tempo real

Serviços, países, preço e estoque por endpoint.

Cashback por volume

Quanto mais você usa, maior o nível VIP e o cashback em saldo.

Comece em 3 passos

Gere sua chave em Minha conta e substitua sk_live_... nos exemplos.

  1. 1Consulte seu saldo
    curl https://www.smsmeu.com/api/v1/balance \
  -H "Authorization: Bearer sk_live_..."
# -> { "balance": 100.00, "currency": "BRL" }
  2. 2Compre um número (desconta do saldo)
    curl -X POST https://www.smsmeu.com/api/v1/purchases \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"service":"wa","country":"55"}'
# -> { "id":"...", "number":"+55...", "status":"fulfilled", "price": 34.90 }
  3. 3Pegue o código (poll até sms_status: received)
    curl https://www.smsmeu.com/api/v1/purchases/{id} \
  -H "Authorization: Bearer sk_live_..."
# -> { "sms_status":"received", "code":"123456", "number":"+55..." }

Endpoints

MétodoRotaDescrição
GET/api/v1/balanceSaldo atual da conta (BRL).
GET/api/v1/services?country=55Catálogo de serviços com preço e estoque.
POST/api/v1/purchasesCompra um número, descontando do saldo.
GET/api/v1/purchases/{id}Status do pedido + número + código do SMS.

Autenticação

Toda requisição usa o header Authorization: Bearer sk_live_.... Gere e revogue chaves em Minha conta → API para desenvolvedores. A chave aparece uma única vez na criação — guarde em segredo e nunca a exponha no front-end.

Códigos de resposta

200 / 201Sucesso.
400Parâmetros inválidos (serviço/país).
401Chave ausente ou inválida.
402Saldo insuficiente — recarregue.
404Pedido não encontrado (ou não é seu).
429Limite de requisições atingido.
502Falha na entrega — o saldo é estornado.

Perguntas frequentes

Preciso pagar mensalidade?

Não. Você paga por uso, descontando do seu saldo. Recarrega quando quiser, via Pix, e consome por API.

Como recarrego o saldo?

Pelo painel em Minha conta, via Pix. Recargas maiores ganham bônus em saldo, e o volume de compras eleva seu nível VIP (mais cashback).

E se o número não receber o SMS?

A entrega é verificada de ponta a ponta. Se o número não for alocado, o saldo é estornado automaticamente. Você acompanha o status pelo endpoint de consulta.

Quais serviços e países estão disponíveis?

Consulte GET /api/v1/services — retorna o catálogo com preço em tempo real e estoque. O mesmo catálogo do site.

Existe limite de requisições?

Sim, um rate limit por conta para proteger a plataforma (ex.: criação de números por minuto e consultas por minuto). Ao atingir, a API responde 429.

Como pego minha chave de API?

Em Minha conta → “API para desenvolvedores (B2B)” → Criar chave. A chave é mostrada uma única vez; guarde em local seguro.

Sem mensalidade · pague por uso

Comece agora

Crie sua conta, recarregue o saldo e gere sua primeira chave.

Gerar minha chave