Verificar um endereço de email
Se vale a pena enviar para um endereço, antes da primeira mensagem.
Executa qualquer uma das 2 chamadas no seu espaço de trabalho.
GET /tools/address
Se vale a pena enviar para um endereço, antes da primeira mensagem.
Exemplo
Não precisa de nenhum scope. result é valid, risky, invalid ou unknown, e reasons diz porquê: sintaxe errada, um domínio que não aceita correio, uma caixa descartável ou partilhada, ou uma gralha provável, com a correção em suggestion. Com emails:read, workspace acrescenta o que este espaço de trabalho sabe sobre o endereço.
curl "$OE/tools/[email protected]" -H "$AUTH"{ "object": "address_check", "email": "[email protected]", "normalized": "[email protected]", "result": "risky", "reasons": ["typo_suspected"], "suggestion": "[email protected]", "checks": { "syntax": true, "mx": { "status": "found", "hosts": ["mx.gmial.com"] }, "nullMx": false, "disposable": false, "role": false, "freeProvider": false, "mailbox": null }, "workspace": { "suppressed": false, "lastBouncedAt": null, "lastDeliveredAt": null }, "checkedAt": "2026-10-11T09:41:00.000Z"}Um endereço com a sintaxe errada não é um erro. Responde 200 com result igual a invalid.
deep=true também pergunta se a caixa existe, em checks.mailbox. Precisa de emails:send e é cobrado por endereço através do pagamento por utilização. Com o pagamento por utilização desligado dá um 409 deep_check_unavailable, e nada é cobrado.
Verificar uma lista
POST /tools/addresses aceita até 100 endereços em emails e responde com uma verificação para cada um, pela ordem em que foram enviados. deep aplica-se a todos.
curl -X POST "$OE/tools/addresses" -H "$AUTH" -H "Content-Type: application/json" \ -d '{ "emails": ["[email protected]", "[email protected]"] }'{ "object": "list", "data": [ { "object": "address_check", "email": "[email protected]", "result": "valid", "reasons": [] }, { "object": "address_check", "email": "[email protected]", "result": "risky", "reasons": ["role_address"] } ]}Mais de 100 endereços, ou nenhum, dá um 422 invalid_parameter em emails.