Skip to main content
List contacts
curl --request GET \
  --url https://api.maildiver.com/v1/audiences/{audienceId}/contacts \
  --header 'Authorization: Bearer <token>'
{
  "contacts": [
    {
      "id": "01959faf-16e2-77dd-9585-cd25da58855e",
      "first_name": null,
      "last_name": null,
      "email": "suppressionlist+9@simulator.amazonses.com",
      "is_subscribed": true,
      "created": 1742140806881,
      "updated": 1742140806881
    },
    {
      "id": "01959faf-16e2-77dd-9586-095806ce56a4",
      "first_name": "John",
      "last_name": null,
      "email": "suppressionlist+24@simulator.amazonses.com",
      "is_subscribed": true,
      "created": 1742140806881,
      "updated": 1742140806881
    }
  ],
  "count": 50,
  "cursor": "suppressionlist+14@simulator.amazonses.com"
}

Documentation Index

Fetch the complete documentation index at: https://docs.maildiver.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

API key with format "Bearer {your-api-key}"

Path Parameters

​
audienceId
string
required

Unique identifier of the audience

Query Parameters

​
cursor
string | null

Pagination cursor. The cursor will always be returned in the response:

  • If there are more contacts, it will contain the email of the last contact in the current page
  • If there are no more contacts, it will be null

Response

OK