API documentation

Listing bounced people

Retrieve all bounced people for your account.

Results are returned in the order in which they were bounced (oldest first). See the parameters section below for more information regarding pagination.

Endpoint

GET /v1/bounces.json

Example request

curl https://api.delighted.com/v1/bounces.json \
  -u YOUR_DELIGHTED_API_KEY:
Delighted::Bounce.all
delighted.bounce.all(); // returns a promise
delighted.Bounce.all()
\Delighted\Bounce::all();

Example response

[
  {
    "person_id": "11837",
    "email": "leslie.wong@example.com",
    "name": "Leslie Wong",
    "bounced_at": 1440621400
  },
  {
    "person_id": "93746",
    "email": "jrryonk@example.com",
    "name": "Jess Rose",
    "bounced_at": 1440623462
  }
]

Parameters

Name Type Description
per_page Integer Number of results to return per page. The default is 20. The maximum is 100.
page Integer The page number to return. The default is 1.
since Integer An optional Unix timestamp to restrict bounces to people bounced on or after this time. Formatting example (for 1 hour ago): 1544436964.
until Integer An optional Unix timestamp to restrict bounces to people bounced on or before this time. Formatting example (for the current time): 1544440564.