Skip to content
Splashify Pro
Email docsEmail

List contacts

The contacts of one audience, 50 at a time, in email address order.

GET

/api/v1/partner/email/audiences/:id/contacts

Connected apps need email.contacts:read, which only verified apps can have. See Connected apps (OAuth).

Parameters

Response

json
{
  "success": true,
  "contacts": [
    {
      "email": "[email protected]",
      "status": "subscribed",
      "first_name": "Asha",
      "last_name": "Rao",
      "attributes": { "city": "Pune" },
      "created_at": "2026-09-01T08:00:00Z"
    }
  ],
  "next_cursor": "[email protected]"
}

next_cursor is there when more contacts may follow. Pass it as cursor to get the next page, and stop when it is missing.

With a status filter, each page is read first and then filtered, so a page can hold fewer than 50 contacts, or none, while next_cursor is still there. Keep paging until next_cursor is missing.

cURL

bash
curl "https://api.splashifypro.com/api/v1/partner/email/audiences/8b2f6c1e-9a4d-4f1b-b6a2-1c3d5e7f9a0b/contacts?status=subscribed" \
  -H "Authorization: Bearer $SPLASHIFY_API_KEY"

Common errors