API docs

Reference · Account

Your bounce reports and what became of them

GET /api/v1/bounces

Your latest 100 reports, newest first, with the result of our check and the credits given back.

Credits: Free.

Example request

Shell
curl "https://moleman.io/api/v1/bounces" \
  -H "Authorization: Bearer $MOLEMAN_API_KEY"

Example answer

JSON
{
  "reports": [
    {
      "email": "office@example.com",
      "status": "refunded",
      "word": "Dead now: credit back",
      "credits": 1,
      "source": "api",
      "reportedAt": 1762344000000,
      "checkedAt": 1762344120000
    }
  ]
}

Errors

StatusCodeWhen
401missing_api_keyThe request has no API key.
401invalid_api_keyThe API key is not one of ours (a typo, a cut-off copy, or a key from another account that was deleted).
401revoked_api_keyThe API key was revoked on the API page (at once), or it was rotated and its 24 hours are over. Old test keys (mm_test_) are revoked too.
401expired_api_keyThe API key reached the expiry date set when it was created.
429rate_limitedMore than 120 requests in one minute with this key.
500server_errorSomething broke on our side. Nothing was charged for it.