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
curl "https://moleman.io/api/v1/bounces" \
-H "Authorization: Bearer $MOLEMAN_API_KEY"Example answer
{
"reports": [
{
"email": "office@example.com",
"status": "refunded",
"word": "Dead now: credit back",
"credits": 1,
"source": "api",
"reportedAt": 1762344000000,
"checkedAt": 1762344120000
}
]
}Errors
| Status | Code | When |
|---|---|---|
| 401 | missing_api_key | The request has no API key. |
| 401 | invalid_api_key | The API key is not one of ours (a typo, a cut-off copy, or a key from another account that was deleted). |
| 401 | revoked_api_key | The 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. |
| 401 | expired_api_key | The API key reached the expiry date set when it was created. |
| 429 | rate_limited | More than 120 requests in one minute with this key. |
| 500 | server_error | Something broke on our side. Nothing was charged for it. |