Documentação da API

Integre verificação de números de telefone em minutos

URL Base

https://api.zelnum.com/api/v1

O domínio da API é separado de propósito do domínio do Console, para permitir escala e proteção independentes. Por isso os exemplos usam api.zelnum.com, enquanto o seu painel fica em app.zelnum.com.

Autenticação

Todos os endpoints exigem uma chave de API no header da requisição.

Formato da Resposta

Todos os endpoints retornam JSON.

Fluxo de Trabalho Típico

Consultar Saldo — GET /v1/balance
Enviar Verificação (Números) — POST /v1/detect · POST /v1/detect/file
Status da Tarefa — GET /v1/tasks/{token}
URL de Download — GET /v1/tasks/{token}/result · GET /v1/tasks/{token}/download

Consulta unitária em tempo real

SDK oficial

O cliente Python encapsula os endpoints desta página: respostas tipadas, chaves de idempotência e download de resultados em lote. Hoje é o único SDK mantido oficialmente — nas demais linguagens, chame a API REST diretamente.

Python — https://github.com/Zelnum/zelnum-python · https://pypi.org/project/zelnum/