# Bounces

Bounces - Bounce list stores events of delivery failures due to permanent recipient mailbox errors such as non-existent mailbox. Soft bounces (for example, mailbox is full) and other failures (for example, ESP rejects an email because it thinks it is spam) are not added to the list.

## Import list of bounces

 - [POST /v3/{domainID}/bounces/import](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/mailgun/bounces/post-v3--domainid--bounces-import.md): Import a CSV file containing a list of addresses to add to the bounce list. The CSV file must be 25MB or under and must contain the following column headers: address, code, error, created_at. address is a valid email address. code is error code (optional, default: 550). error is error description (optional, default: empty string). created_at is timestamp of bounce event in RFC2822 format (optional, default: current time)

## Lookup bounce record

 - [GET /v3/{domainID}/bounces/{address}](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/mailgun/bounces/get-v3--domainid--bounces--address-.md): Fetch a single bounce event by a given email address.

## Remove bounce

 - [DELETE /v3/{domainID}/bounces/{address}](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/mailgun/bounces/delete-v3--domainid--bounces--address-.md): Delivery to the deleted email address resumes until it bounces again.

## List all bounces

 - [GET /v3/{domainID}/bounces](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/mailgun/bounces/get-v3--domainid--bounces.md): Paginate over a list of bounces for a domain.

## Add bounces

 - [POST /v3/{domainID}/bounces](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/mailgun/bounces/post-v3--domainid--bounces.md): Request body is expected to be a valid JSON encoded sting containing up to 1000 bounce records or a single bounce record as application/form-data

## Clear all bounces

 - [DELETE /v3/{domainID}/bounces](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/mailgun/bounces/delete-v3--domainid--bounces.md): Clears all email addresses with bounces from the domain. Delivery to the deleted email addresses will longer be suppressed.