---
title: "Bounce reasons"
method: GET
path: "/v1/bounce-reasons"
tags: ["Reference"]
---

# Bounce reasons

`GET /v1/bounce-reasons`

## Request

- Base URL: `https://data.inboxpro.io`
- URL: `https://data.inboxpro.io/v1/bounce-reasons`
- Auth: HTTP bearer

Every bounce reason the API can return, what it means, and what to do about it.

## Response `200`

Default Response

- object
  - `bounce_reasons` object[], required
    - `reason` string, required: Reason id, as used in campaign details.
    - `label` string, required
    - `description` string, required: What happened.
    - `action` string, required: What we recommend you do.
    - `kind` 'permanent' | 'temporary' | 'not_sent' | 'mixed', required: `permanent`: remove the address. `temporary`: the receiving server may accept it later. `not_sent`: refused before sending. `mixed`: depends on the case.

## Other responses

- `401`: The API key is missing, invalid, or revoked.
- `429`: Too many requests in a short time, or the daily request quota is used up.

---

[API](https://skmtc.dev/inboxpro/apis/inboxpro-stats-api.md) - [All operations](https://skmtc.dev/inboxpro/apis/inboxpro-stats-api/llms.txt) - [OpenAPI document](https://skmtc.dev/inboxpro/apis/inboxpro-stats-api/revisions/e0a4b5c280ce?raw)