Cada parâmetro, a resposta ao vivo e cada sucesso/erro documentado estão em uma única tela.
getNumber
V1
GET / POST
Compre um número de telefone para um serviço/país.
Aceita valores separados por vírgula — um recurso exclusivo da Tiger SMS.
Aceitos, mas atualmente ignorados (sem regra de validação, descartados silenciosamente, sem erro): operator, phoneException, minPrice.
A detecção automática de país (ex.: `country=any`) não é suportada: `country` deve ser um código numérico de país — um country não numérico ou desconhecido retorna BAD_COUNTRY.
Neste método, as listas separadas por vírgulas são suportadas apenas para providerIds/exceptProviderIds. Os parâmetros de nível superior `service`/`country` não aceitam listas com vírgulas aqui — esse recurso chegará em breve apenas aos métodos de consulta de preços (getPrices/getFreePrices/getPricesV2/getPricesV3).
getNumberTest se comporta exatamente como getNumber, mas é a forma documentada de passar explicitamente activationType/testParams.
Esta é uma solicitação real — uma chamada bem-sucedida pode cobrar do seu saldo ou alterar uma ativação real.
Faça login para executar esta solicitação com sua própria chave de API.
EntrarInscrição
Todas as respostas documentadas
setStatus
V1
GET / POST
Altera o status de uma ativação (ready/retry/cancel/complete).
A resposta é sempre um token de status em texto simples, nunca um envelope JSON — use setStatusV2 se você precisar de JSON.
Faça login para executar esta solicitação com sua própria chave de API.
EntrarInscrição
Todas as respostas documentadas
getStatus
V1
GET / POST
Consulte (polling) o status/código de uma ativação.
Faça login para executar esta solicitação com sua própria chave de API.
EntrarInscrição
Todas as respostas documentadas
getPrices
V1
GET / POST
Mapa simples de preço/quantidade por país e serviço.
Aceita valores separados por vírgula — um recurso exclusivo da Tiger SMS.
Um código service/country desconhecido ou removido retorna BAD_SERVICE/BAD_COUNTRY. Um código válido que simplesmente não tem variação oferecida para o par ainda produz um resultado vazio (a chave é omitida).
Listas separadas por vírgula (quando habilitadas): cada token é validado da mesma forma que um valor único; se nenhum dos códigos listados existir, BAD_SERVICE/BAD_COUNTRY é retornado.
Faça login para executar esta solicitação com sua própria chave de API.
EntrarInscrição
Todas as respostas documentadas
getFreePrices
V2
GET / POST
Mapa detalhado de faixas de preço (price => count, flag multi-SMS) por país/serviço.
Aceita valores separados por vírgula — um recurso exclusivo da Tiger SMS.
Faça login para executar esta solicitação com sua própria chave de API.
EntrarInscrição
Todas as respostas documentadas
getPricesV2
V2
GET / POST
Alias de getFreePrices.
Aceita valores separados por vírgula — um recurso exclusivo da Tiger SMS.
Faça login para executar esta solicitação com sua própria chave de API.
EntrarInscrição
Todas as respostas documentadas
getBalance
V1
GET / POST
Saldo atual da conta.
BAD_KEY (HTTP 401) é retornado antes mesmo de este método ser executado, sempre que a chave de API estiver ausente ou for inválida — isso se aplica a todos os métodos, não apenas a este.
Faça login para executar esta solicitação com sua própria chave de API.
EntrarInscrição
Todas as respostas documentadas
getServiceNumbersCount
V1
GET / POST
Quantidade de números disponíveis para um serviço/país.
Faça login para executar esta solicitação com sua própria chave de API.
EntrarInscrição
Todas as respostas documentadas
getProviders
V1
GET / POST
Lista pública de provedores (id/name/numbers_count/delivery_percent/number_lifetime, sem preço).
Faça login para executar esta solicitação com sua própria chave de API.
EntrarInscrição
Todas as respostas documentadas
getNumberV2
V2Novo
GET / POSTapi_get_number_v2_enabled
Purchase a phone number, full typed JSON success/error envelope.
Aceita valores separados por vírgula — um recurso exclusivo da Tiger SMS.
Esta é uma solicitação real — uma chamada bem-sucedida pode cobrar do seu saldo ou alterar uma ativação real.
Faça login para executar esta solicitação com sua própria chave de API.
EntrarInscrição
Todas as respostas documentadas
getStatusV2
V2Novo
GET / POSTapi_get_status_v2_enabled
Activation status as JSON (verificationType + sms block).
Faça login para executar esta solicitação com sua própria chave de API.
EntrarInscrição
Faça login para executar esta solicitação com sua própria chave de API.
EntrarInscrição
Todas as respostas documentadas
getPricesV3
V3Novo
GET / POSTapi_prices_v3_enabled
Price/count map with a per-provider price breakdown.
Aceita valores separados por vírgula — um recurso exclusivo da Tiger SMS.
Ao contrário de todos os outros métodos JSON desta família, um erro interno inesperado aqui retorna a resposta BAD_ACTION em texto simples em vez de um corpo JSON — isso é intencional, para que um cliente que faz parsing de JSON nunca receba um corpo JSON mal formado.
Listas separadas por vírgulas (em breve): serão acionadas quando service ou country contiver uma vírgula; cada token é validado da mesma forma que um valor único, e cada lista é limitada a 50 itens com um total de 100 combinações country×service.
Faça login para executar esta solicitação com sua própria chave de API.
EntrarInscrição
Todas as respostas documentadas
getOffers
V3Novo
GET / POSTapi_offers_enabled
Combined price+stock showcase: default/retail/min price, counts and the full price-bucket map, by service and country.
Requires the same price-bucket data as getFreePrices/getPricesV3 — when that data isn't available for this account, this method returns an empty `data: {}` rather than falling back to catalog prices.
There is no `counts.physical` field: our provider module does not currently expose a physical stock figure separate from `counts.total`, and this method does not invent one. It may be added later if that data becomes available.
Never exposes providers, cost, or purchase price — none of those exist in this response by design.
Faça login para executar esta solicitação com sua própria chave de API.
EntrarInscrição
Todas as respostas documentadas
getServicesList
V1Novo
GET / POSTapi_catalog_enabled
Catalog of services (code + name), optionally localized.
O único modo de falha deste método é uma resposta 200 de sucesso com uma lista de serviços vazia — não há uma resposta de erro dedicada.
Faça login para executar esta solicitação com sua própria chave de API.
EntrarInscrição
Todas as respostas documentadas
getCountries
V1Novo
GET / POSTapi_catalog_enabled
Catalog of countries (id + localized names).
Degrada para um array JSON vazio `[]` em caso de falha inesperada, em vez de uma resposta de erro.
Faça login para executar esta solicitação com sua própria chave de API.
EntrarInscrição
Todas as respostas documentadas
getActiveActivations
V1Novo
GET / POSTapi_active_activations_enabled
List of currently active activations for the key owner.
Nunca retorna erro em caso de falha inesperada (mesma filosofia de getServicesList/getCountries) — degrada para uma lista `data: []` vazia mantendo o status em "success".
Valores de activationStatus: 1=WAIT_CODE, 2=WAIT_ACCEPTING, 3=WAIT_NEXT_SMS, 6=OK, 7=REFUND, 8=CANCEL — esta numeração é específica nossa e pode diferir de outras APIs de SMS que você já tenha usado.
Faça login para executar esta solicitação com sua própria chave de API.
EntrarInscrição
Todas as respostas documentadas
Webhook de SMS recebido
Receba os SMS recebidos enviados (push) para o seu próprio endpoint HTTPS assim que chegarem, em vez de fazer polling em getStatus/getStatusV2.
Exemplo de payload
POSTapplication/json
Um POST para cada segmento de SMS recebido, enviado à URL que você registrou. Somente uma resposta HTTP 200 conta como aceita; redirecionamentos não são seguidos.
activationId Id da ativação, o mesmo valor do parâmetro `id` usado por getStatus/getStatusV2.
service Código de serviço no estilo sms_activate para o qual o número foi comprado.
code O segmento de código extraído do SMS, o mesmo valor que getStatus retorna após os dois-pontos.
text Texto completo do SMS quando o provedor o fornece; caso contrário, idêntico a `code`.
country Código de país numérico (sms_activate_code), ou null se o país da ativação não tiver um definido.
receivedAt Timestamp ISO 8601 (UTC) de quando o SMS foi recebido.
Verificação de assinatura
X-SignatureHMAC-SHA256
HMAC-SHA256 em hexadecimal do corpo JSON bruto da solicitação, gerado com o seu segredo do webhook. Recalcule-o da mesma forma no seu lado e compare antes de confiar no payload.
Política de novas tentativas
Até 3 tentativas no total: 5s, depois 30s, depois 120s entre tentativas. Cada tentativa expira após 10s. Se todas as tentativas falharem, o evento é descartado silenciosamente — não há fila de mensagens mortas (dead-letter) nem alertas.
Seu endpoint deve ser uma URL HTTPS pública; endereços privados, de loopback, link-local e outros endereços internos são rejeitados tanto ao salvar a URL quanto em cada tentativa de entrega (o DNS é resolvido novamente e fixado por solicitação para evitar rebinding).
O segredo de assinatura é gerado uma única vez automaticamente e armazenado por conta; é o mesmo segredo para cada entrega até que o suporte o altere.
