---
title: "Email bounces"
method: POST
path: "/stats/email_bounces"
tags: ["STATISTICS"]
---

# Email bounces

`POST /stats/email_bounces`

## Request

- Base URL: `https://api.smtp2go.com/v3`
- URL: `https://api.smtp2go.com/v3/stats/email_bounces`
- Auth: one of:
  - API key in header `X-Smtp2go-Api-Key`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/smtp2go/apis/smtp2go-api-v3-0-4/docs/stats/email_bounces/post.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve a summary of bounces and rejects, for the last 30 days.

## Request body

- object
  - `username` string: Allows statistics to be returned for a specific user.

## Response `200`

Bounce report

- object
  - `request_id` string, required
  - `data` object, required
    - `emails` integer, required
    - `hardbounces` integer, required
    - `bounce_percent` string, required
    - `softbounces` integer, required
    - `rejects` integer, required

## Other responses

- `400`: 400

---

[API](https://skmtc.dev/smtp2go/apis/smtp2go-api-v3-0-4.md) - [All operations](https://skmtc.dev/smtp2go/apis/smtp2go-api-v3-0-4/llms.txt) - [OpenAPI document](https://skmtc.dev/smtp2go/apis/smtp2go-api-v3-0-4/revisions/313dcf9dd255?raw)