1. Sign in

API documentation

Table of contents

  1. Introduction
  2. Libraries
  3. Sending to people
  4. Listing survey responses
  5. Getting metrics
  6. Adding survey responses
  7. Deleting pending survey requests
  8. Unsubscribing people
  9. Listing people
  10. Listing unsubscribed people
  11. Listing bounced people
  12. Deleting people
  13. Getting Autopilot configuration
  14. Listing people in Autopilot
  15. Adding people to Autopilot
  16. Removing people from Autopilot
  17. Webhooks
  18. Web snippet

Listing unsubscribed people

Retrieve all unsubscribed people for your account.

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

Endpoint 

GET /v1/unsubscribes.json

Example request

Curl Ruby Node.js Python PHP 
curl https://api.delighted.com/v1/unsubscribes.json \
  -u YOUR_DELIGHTED_API_KEY:
Delighted::Unsubscribe.all
delighted.unsubscribe.all(); // returns a promise
delighted.Unsubscribe.all()
\Delighted\Unsubscribe::all();

Example response 

[
  {
    "person_id": "11837",
    "email": "leslie.wong@example.com",
    "name": "Leslie Wong",
    "unsubscribed_at": 1437432834
  },
  {
    "person_id": "93746",
    "email": "jrryonk@example.com",
    "name": "Jess Rose",
    "unsubscribed_at": 1437434050
  }
]

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 unsubscribes to people unsubscribed on or after this time. Formatting example (for 1 hour ago): 1732249174.
until Integer An optional Unix timestamp to restrict unsubscribes to people unsubscribed on or before this time. Formatting example (for the current time): 1732252774.