Skip to main content
GET
/
api
/
campaigns
/
audience-lists
/
{audienceId}
/
contacts
Get all contacts in audience list
curl --request GET \
  --url https://apiv1.delightloop.ai/api/campaigns/audience-lists/{audienceId}/contacts \
  --header 'x-api-key: <x-api-key>'
{
  "success": true,
  "message": "Contacts retrieved successfully",
  "data": {
    "audience": {
      "audienceId": "audience_clx7k2m0p0001j5k8c5z9w8h4",
      "organizationId": "org_12345",
      "createdBy": "user_67890",
      "name": "Marketing Prospects Q1",
      "icpId": "icp_12345_tech_startups",
      "totalMatch": 150,
      "creditRequired": 75,
      "status": "list-building",
      "tags": [
        "high-priority",
        "tech-companies",
        "q1-campaign"
      ],
      "createdAt": "2024-08-07T10:30:00.000Z",
      "updatedAt": "2024-08-07T15:45:00.000Z",
      "description": "High-value prospects for Q1 marketing campaign targeting tech companies",
      "metadata": {}
    },
    "items": [
      "<unknown>"
    ],
    "pagination": {
      "page": 1,
      "limit": 12,
      "total": 50,
      "totalPages": 5
    }
  }
}

Headers

​
x-api-key
string
required

auth key

Path Parameters

​
audienceId
string
required

Unique identifier of the audience list

Example:

"audience_clx7k2m0p0001j5k8c5z9w8h4"

Query Parameters

​
page
number

Page number for pagination

Required range: x >= 1
Example:

1

​
limit
number

Number of items per page

Required range: 1 <= x <= 100
Example:

10

​
search
string

Search term for filtering contacts

Example:

"john"

​
sortBy
enum<string>

Field to sort by

Available options:
createdAt,
updatedAt,
contactId
Example:

"createdAt"

​
sortOrder
enum<string>

Sort order

Available options:
asc,
desc
Example:

"desc"

Response

Contacts retrieved successfully

​
success
boolean
Example:

true

​
message
string
Example:

"Contacts retrieved successfully"

​
data
object