Recipients

Who bounced

Recipients whose mail server refused the campaign, with the reason, most bounces first. An address can appear once per reason. Remove addresses whose kind is permanent from your list.

An unknown subject returns an empty list. Requires an API key with the recipients:read permission.

get/v1/domains/{domain}/campaigns/bounces

Request

  • Base URL
    https://data.inboxpro.io
  • Auth
    HTTP bearer

Path parameters

domainstring required

One of your sending domains (the part after @ in your From address).

Query parameters

subjectstring required

The exact subject line of the campaign, as returned by the campaigns list.

fromstring date

First day to include, YYYY-MM-DD (UTC). Defaults to 6 days before to.

tostring date

Last day to include, YYYY-MM-DD (UTC). Defaults to today. The range can span at most 90 days.

pageinteger

Page number, starting at 1.

page_sizeinteger

Rows per page (max 100).

Response

Default Response

domainstring required
subjectstring required
bots_excludedboolean required
data_as_ofstring date-time required

Numbers include activity up to this moment. Recent hours may still change slightly.

Example response

{
  "recipients": [
    {
      "email": "jane@example.org",
      "reason": "invalid_recipient",
      "label": "Mailbox does not exist",
      "bounces": 1
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.