# 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

```bash
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

| Status | Code | When |
| --- | --- | --- |
| 401 | [`missing_api_key`](/docs/errors#missing_api_key) | The request has no API key. |
| 401 | [`invalid_api_key`](/docs/errors#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`](/docs/errors#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`](/docs/errors#expired_api_key) | The API key reached the expiry date set when it was created. |
| 429 | [`rate_limited`](/docs/errors#rate_limited) | More than 120 requests in one minute with this key. |
| 500 | [`server_error`](/docs/errors#server_error) | Something broke on our side. Nothing was charged for it. |