Verificação de e-mails

Verifique um único endereço em tempo real.

URL basehttps://api.emailit.com/v2Autenticação Erros Limites de requisições

Verificar um endereço

Verifica um endereço de e-mail e retorna o resultado na resposta. Cada verificação custa 5 créditos, cobrados antes de a verificação ser executada. Para verificar muitos endereços de uma vez, crie uma lista de verificação. Requer uma chave de API com escopo full.

POST/email-verifications

Corpo da requisição

emailstringObrigatório

Endereço a verificar. Um valor que não é um endereço válido também retorna 200, com result: "invalid" e pontuação 0, e é cobrado.

modestring

fast (padrão) verifica a sintaxe, endereços descartáveis e genéricos, provedores gratuitos, sequências sem sentido, registros MX e a idade do domínio. full também se conecta ao servidor de e-mail do destinatário para verificar se a caixa de e-mail existe, está desativada ou está cheia, e se o domínio aceita todos os endereços. No modo fast, as verificações da caixa de e-mail são null.

Retorno

Retorna 200 OK com um objeto email_verification. O Emailit também envia um evento de webhook email_verification.created.

Status	Quando
`400`	`email` está ausente ou `mode` não é `fast` nem `full` (erro de validação padrão).
`402`	O workspace não tem mais 5 créditos. O corpo é `{"error": {"message": "…", "code": 402}}`.

Resultado

`result`	Significado
`safe`	Passou em todas as verificações e teve pontuação 70 ou mais.
`invalid`	A sintaxe é inválida ou o domínio não tem registros MX, então ele não pode receber e-mails.
`disposable`	O domínio pertence a um serviço de e-mail descartável.
`disabled`	A caixa de e-mail existe, mas está desativada. Apenas no modo `full`.
`inbox_full`	A caixa de e-mail está cheia. Apenas no modo `full`.
`role`	Um endereço genérico, como `info@` ou `support@`.
`unknown`	Nenhuma verificação falhou, mas a pontuação está abaixo de 70.

Pontuação e risco

score vai de 0 a 100. risk é high quando a sintaxe é inválida, o domínio não tem registros MX, o endereço é descartável ou a caixa de e-mail está desativada. Nos outros casos, ele acompanha a pontuação: low a partir de 80, medium a partir de 50 e high abaixo de 50.

Campos

statusstring

completed nas verificações individuais.

checksobject

As verificações individuais: valid_syntax, disposable, role_account, free_email, gibberish e has_mx_records (booleanos), domain_age (idade do domínio em dias, ou null se for desconhecida) e as verificações do modo full smtp_connect, deliverable, disabled, inbox_full e catch_all (null no modo fast).

addressobject

O endereço dividido em mailbox, domain, suffix (a parte depois do +, ou null) e root (o endereço sem o sufixo).

did_you_meanstring | null

Sugestão de correção para um provável erro de digitação, por exemplo, ada@gmail.com para ada@gmial.com.

mx_recordsobject[]

Os registros MX do domínio, cada um com priority e exchange.

POST/email-verifications

JavaScript

import { Emailit } from '@emailit/node';
const emailit = new Emailit('your_api_key');

const result = await emailit.emailVerifications.verify({ email: 'ada@example.com' });

Python

from emailit import EmailitClient
client = EmailitClient("your_api_key")

result = client.email_verifications.verify({"email": "ada@example.com"})

PHP

$emailit = Emailit::client('your_api_key');

$result = $emailit->emailVerifications()->verify(['email' => 'ada@example.com']);

Ruby

require "emailit"
client = Emailit::EmailitClient.new("your_api_key")

result = client.email_verifications.verify(email: "ada@example.com")

import "github.com/emailit/emailit-go/v2"
client := emailit.NewClient("your_api_key")

result, err := client.EmailVerifications.Verify(&emailit.VerifyEmailRequest{Email: "ada@example.com"})

Rust

use emailit::Emailit;
let emailit = Emailit::new("your_api_key");

let result = emailit.email_verifications.verify(emailit::types::VerifyEmailParams::new("ada@example.com")).await?;

Java

import com.emailit.*;
import com.emailit.params.*;

EmailitClient emailit = new EmailitClient("your_api_key");

EmailitObject result = emailit.emailVerifications().create(EmailVerificationCreateParams.builder().setEmail("ada@example.com").build());

using Emailit;

var emailit = new EmailitClient("your_api_key");

var result = emailit.EmailVerifications.Verify(new EmailVerificationVerifyOptions { Email = "ada@example.com" });

PHP

use Emailit\Laravel\Facades\Emailit;

$result = Emailit::emailVerifications()->verify(['email' => 'ada@example.com']);

Terminal

curl -X POST https://api.emailit.com/v2/email-verifications \
  -H "Authorization: Bearer your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"email": "ada@example.com"}'

JSON

{
  "id": "ev_2xLd4Wq8Bn1Ys6Pk3Rm9Tc0Fh5a",
  "object": "email_verification",
  "email": "ada@example.com",
  "status": "completed",
  "score": 100,
  "risk": "low",
  "result": "safe",
  "mode": "fast",
  "checks": {
    "valid_syntax": true,
    "disposable": false,
    "role_account": false,
    "inbox_full": null,
    "deliverable": null,
    "disabled": null,
    "catch_all": null,
    "free_email": false,
    "smtp_connect": null,
    "has_mx_records": true,
    "domain_age": 10957,
    "gibberish": false
  },
  "address": {
    "mailbox": "ada",
    "domain": "example.com",
    "suffix": null,
    "root": "ada@example.com"
  },
  "did_you_mean": null,
  "mx_records": [
    { "priority": 10, "exchange": "mx1.example.com" }
  ],
  "created_at": "2026-10-01T10:20:31.118000+00:00",
  "updated_at": "2026-10-01T10:20:31.118000+00:00"
}

JSON

{
  "error": {
    "message": "Workspace has insufficient email credits for email verification. Each verification requires 5 credits.",
    "code": 402
  }
}