Reference · Account

Report emails that bounced

POST /api/v1/bounces

Tell us which emails bounced. We check each address again ourselves, usually within minutes, and if it is dead now you get back what you were charged for it, once. Charges of the last 30 days count. An address that still accepts mail, or that we cannot confirm, gets no credit back. See Credits. The answer says what happens to each address; ask the list of reports for the result.

Credits: Free.

Body (JSON)

Example request

curl -X POST "https://moleman.io/api/v1/bounces" \
  -H "Authorization: Bearer $MOLEMAN_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"emails":["office@example.com"]}'

Example answer

{
  "checking": 1,
  "leftToday": 999,
  "reports": [
    {
      "email": "office@example.com",
      "status": "checking",
      "word": "Checking it again"
    }
  ]
}

Errors