Skip to main content
GET
/
audiences
List audiences
curl --request GET \
  --url https://api.maildiver.com/v1/audiences \
  --header 'Authorization: Bearer <token>'
{
  "audiences": [
    {
      "id": "0195be2b-bb85-7368-85c0-9f250e629157",
      "name": "test",
      "created_by": {
        "email": "[email protected]",
        "first_name": null,
        "last_name": null,
        "profile_picture": "https://cdn.company.com/profiles/admin-avatar.jpg"
      },
      "created": 1742652291974,
      "updated": 1742652291974,
      "contact_count": 0,
      "unsubscribers": 0
    },
    {
      "id": "01959fae-cb50-7676-8c6f-9818acfd0b07",
      "name": "Enterprise users",
      "created_by": {
        "email": "[email protected]",
        "first_name": null,
        "last_name": null,
        "profile_picture": "https://cdn.company.com/profiles/admin-avatar.jpg"
      },
      "created": 1742140787536,
      "updated": 1742140831694,
      "contact_count": 301,
      "unsubscribers": 0
    }
  ],
  "count": 7,
  "cursor": null
}

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
cursor
string | null

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

  • If there are more audiences, it will contain the ID of the last audience in the current page
  • If there are no more audiences, it will be null

Response

OK