Quick Start

Do cadastro limpo à primeira verificação em poucos passos. E-mail usa validations:email; telefone usa validations:phone; CPF usa validations:cpf. A cobrança segue o modo ou SKU — Modos e cobrança.

Em poucas palavras

E-mail — confere se o endereço existe antes de enviar campanha ou transacional.
Telefone — confere formato e, no modo completo, se tem WhatsApp.
CPF — modo rápida (formato) ou completa (base oficial do governo via parceria).
Até 10 na API síncrona ou painel; lotes grandes via batch assíncrono.

Antes de começar

Item	E-mail	Telefone	CPF
Escopo na chave	`validations:email`	`validations:phone`	`validations:cpf`
Créditos ou PAYG	Sim	Sim	Sim
Autenticação	`Authorization: Bearer sk_live_...` ou `x-api-key`	Idem	Idem

Base URL: https://api.notifique.dev.

E-mail — verificação imediata (até 10)

Manda a lista e recebe o resultado na mesma resposta — ideal no cadastro ou antes de importar uma planilha pequena.

POST /v1/validations/email
Content-Type: application/json
Authorization: Bearer sk_live_xxxxx

Modo rápida — formato, domínio descartável e MX (mais barato):

{
  "emails": ["cliente@example.com", "bounce@dominio-invalido.xyz"],
  "mode": "quick"
}

Modo completa — inclui checagem de caixa de entrada (mais profunda):

{
  "emails": ["cliente@example.com"],
  "mode": "full"
}

Resposta 200:

{
  "success": true,
  "data": {
    "mode": "quick",
    "total_credits_charged": 1,
    "results": [
      {
        "email": "cliente@example.com",
        "status": "valid",
        "reason": null,
        "disposable": false,
        "mx_found": true,
        "catch_all": false,
        "suggested_spelling": null,
        "credits_charged": 1
      },
      {
        "email": "bounce@dominio-invalido.xyz",
        "status": "invalid",
        "reason": "MX record not found",
        "disposable": false,
        "mx_found": false,
        "catch_all": null,
        "suggested_spelling": null,
        "credits_charged": 0
      }
    ]
  }
}

E-mail — lote grande (até 10.000)

Para listas grandes, o processamento roda em background — você consulta o progresso depois.

POST /v1/validations/email/batch

{
  "emails": ["a@example.com", "b@example.com"],
  "mode": "full"
}

Resposta 200 (job enfileirado):

{
  "success": true,
  "data": {
    "job_id": "job_email_abc123",
    "status": "queued",
    "total": 2,
    "mode": "full"
  }
}

Consulte o progresso:

GET /v1/validations/email/batch/{jobId}

Telefone — verificação imediata (até 10)

Mesma ideia: manda até 10 números e recebe o resultado na resposta.

POST /v1/validations/phone
Content-Type: application/json
Authorization: Bearer sk_live_xxxxx

Modo rápida — formato internacional e tipo de linha:

{
  "phones": ["+5511999999999", "+14155552671"],
  "mode": "quick"
}

Modo completa — inclui checagem de WhatsApp:

{
  "phones": ["+5511999999999"],
  "mode": "full"
}

Resposta 200:

{
  "success": true,
  "data": {
    "mode": "full",
    "total_credits_charged": 5,
    "results": [
      {
        "phone": "+5511999999999",
        "status": "valid",
        "phone_valid": true,
        "line_type": "mobile",
        "country_code": "BR",
        "whatsapp_registered": true,
        "reason": null,
        "credits_charged": 5
      }
    ]
  }
}

No modo quick, whatsapp_registered vem null (WhatsApp não é verificado).

Telefone — lote grande (500 a 10.000)

POST /v1/validations/phone/batch

{
  "phones": ["+5511999999999", "+5511888888888"],
  "mode": "full"
}

O batch de telefone exige mínimo 500 números por job. Para listas menores, use o painel ou a rota síncrona.

Status do job:

GET /v1/validations/phone/batch/{jobId}

CPF — consulta imediata (até 10)

Envie pares CPF + data de nascimento e escolha o modo. Padrão: quick.

POST /v1/validations/cpf
Content-Type: application/json
Authorization: Bearer sk_live_xxxxx

Modo rápida — valida dígitos do CPF e formato da data (mais barato):

{
  "items": [
    { "cpf": "12345678909", "birthDate": "1990-01-01" }
  ],
  "mode": "quick"
}

Resposta 200 (válido localmente):

{
  "success": true,
  "data": {
    "mode": "quick",
    "totalCreditsCharged": 1,
    "results": [
      {
        "cpf": "12345678909",
        "birthDate": "1990-01-01",
        "status": "valid",
        "resultCode": 8,
        "reason": null,
        "name": null,
        "socialName": null,
        "registrationStatus": null,
        "registeredBirthDate": null,
        "deceasedIndicator": null,
        "creditsCharged": 1
      }
    ]
  }
}

Modo completa — consulta na base oficial do governo (via parceria). Envie vários pares na mesma requisição — cada item retorna seu próprio status:

{
  "items": [
    { "cpf": "12345678909", "birthDate": "1990-01-01" },
    { "cpf": "11144477735", "birthDate": "2015-06-10" }
  ],
  "mode": "full"
}

Resposta 200 (adulto encontrado + menor bloqueado na mesma resposta):

{
  "success": true,
  "data": {
    "mode": "full",
    "totalCreditsCharged": 1800,
    "results": [
      {
        "cpf": "12345678909",
        "birthDate": "1990-01-01",
        "status": "found",
        "resultCode": 1,
        "reason": null,
        "name": "Maria da Silva",
        "socialName": null,
        "registrationStatus": { "code": "0", "description": "Regular" },
        "registeredBirthDate": "1990-01-01",
        "deceasedIndicator": null,
        "creditsCharged": 900
      },
      {
        "cpf": "11144477735",
        "birthDate": "2015-06-10",
        "status": "minorBlocked",
        "resultCode": 3,
        "reason": "Query blocked for minor data protected by LGPD.",
        "name": null,
        "socialName": null,
        "registrationStatus": null,
        "registeredBirthDate": null,
        "deceasedIndicator": null,
        "creditsCharged": 900
      }
    ]
  }
}

Outros status possíveis no mesmo array: notFound (CPF não encontrado), invalid (CPF ou data inválidos — não cobra). Veja Consulta de CPF.

Exemplo isolado — não encontrado (ainda cobra a consulta no modo completa):

{
  "success": true,
  "data": {
    "mode": "full",
    "totalCreditsCharged": 900,
    "results": [
      {
        "cpf": "98765432100",
        "birthDate": "1985-03-15",
        "status": "notFound",
        "resultCode": 2,
        "reason": "CPF not found.",
        "name": null,
        "socialName": null,
        "registrationStatus": null,
        "registeredBirthDate": null,
        "deceasedIndicator": null,
        "creditsCharged": 900
      }
    ]
  }
}

CPF — lote grande (até 10.000)

POST /v1/validations/cpf/batch

{
  "items": [
    { "cpf": "12345678909", "birthDate": "1990-01-01" },
    { "cpf": "98765432100", "birthDate": "1985-03-15" }
  ],
  "mode": "full"
}

Resposta 200 (job enfileirado):

{
  "success": true,
  "data": {
    "jobId": "job_cpf_abc123",
    "status": "queued",
    "total": 2,
    "mode": "full"
  }
}

Consulte o progresso:

GET /v1/validations/cpf/batch/{jobId}

Diferente do batch de telefone, não há mínimo de 500 — qualquer lote de 1 a 10.000 itens é aceito.

Painel (sem código)

Add-on	Caminho no painel	Limite
E-mail	Add-ons → Validação de e-mail	10 por verificação
Telefone	Add-ons → Validação de telefone	10 por verificação
CPF	Add-ons → Consulta de CPF	10 por verificação

Cole a lista, escolha Rápida ou Completa e veja os resultados à direita.

Add-ons

Forms

Forms

Links curtos

Short links

Validações

Validação (API)

Conversões

Em poucas palavras

Antes de começar

E-mail — verificação imediata (até 10)

E-mail — lote grande (até 10.000)

Telefone — verificação imediata (até 10)

Telefone — lote grande (500 a 10.000)

CPF — consulta imediata (até 10)

CPF — lote grande (até 10.000)

Painel (sem código)

Próximos passos

​Em poucas palavras

​Antes de começar

​E-mail — verificação imediata (até 10)

​E-mail — lote grande (até 10.000)

​Telefone — verificação imediata (até 10)

​Telefone — lote grande (500 a 10.000)

​CPF — consulta imediata (até 10)

​CPF — lote grande (até 10.000)

​Painel (sem código)

​Próximos passos

Em poucas palavras

Antes de começar

E-mail — verificação imediata (até 10)

E-mail — lote grande (até 10.000)

Telefone — verificação imediata (até 10)

Telefone — lote grande (500 a 10.000)

CPF — consulta imediata (até 10)

CPF — lote grande (até 10.000)

Painel (sem código)

Próximos passos