Comprobar una dirección de correo
Si vale la pena escribir a una dirección, antes del primer mensaje.
Ejecuta cualquiera de las 2 llamadas en tu espacio de trabajo.
GET /tools/address
Si vale la pena escribir a una dirección, antes del primer mensaje.
Ejemplo
No necesita ningún scope. result es valid, risky, invalid o unknown, y reasons dice por qué: sintaxis incorrecta, un dominio que no acepta correo, un buzón desechable o compartido, o un error de escritura probable, con la corrección en suggestion. Con emails:read, workspace añade lo que este espacio de trabajo sabe de la dirección.
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"}Una dirección con la sintaxis incorrecta no es un error. Responde 200 con result en invalid.
deep=true también pregunta si el buzón existe, en checks.mailbox. Necesita emails:send y se cobra por dirección mediante el pago por uso. Con el pago por uso desactivado es un 409 deep_check_unavailable, y no se cobra nada.
Comprobar una lista
POST /tools/addresses acepta hasta 100 direcciones en emails y responde con una comprobación para cada una, en el orden en que se enviaron. deep se aplica a todas.
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"] } ]}Más de 100 direcciones, o ninguna, es un 422 invalid_parameter en emails.