Skip to main content
GET
/
api
/
campaigns
/
contact-lists
/
{listId}
/
contacts-details
Get detailed contacts in list with pagination and filters
curl --request GET \
  --url https://apiv1.delightloop.ai/api/campaigns/contact-lists/{listId}/contacts-details \
  --header 'x-api-key: <x-api-key>'
{
  "success": true,
  "statusCode": 200,
  "message": "Detailed contacts retrieved successfully",
  "data": {
    "items": [
      "<unknown>"
    ],
    "pagination": {
      "page": 1,
      "limit": 12,
      "total": 150,
      "totalPages": 8
    }
  },
  "timestamp": "2023-11-07T05:31:56Z"
}

Headers

​
x-api-key
string
required

auth key

Path Parameters

​
listId
string
required

Contact list identifier

Example:

"list_clx7k2m0p0001j5k8c5z9w8h4"

Query Parameters

​
page
number

Page number for pagination

Required range: x >= 1
Example:

1

​
limit
number

Number of items per page (max 100)

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

12

​
search
string

Search term for filtering contacts by name, email, company, or job title

Example:

"john"

​
tags
string

Filter by contact tags (comma-separated)

Example:

"developer,senior"

​
company
string

Filter by company name

Example:

"TechCorp"

​
jobTitle
string

Filter by job title

Example:

"Software Engineer"

​
sortBy
enum<string>

Field to sort by

Available options:
firstName,
lastName,
mailId,
companyName,
jobTitle,
addedAt
​
sortOrder
enum<string>

Sort order

Available options:
asc,
desc
​
campaignIds
string

Filter by campaign IDs (comma-separated)

Example:

"campaign_123,campaign_456"

Response

Detailed contacts retrieved successfully

​
success
boolean
Example:

true

​
statusCode
number
Example:

200

​
message
string
Example:

"Detailed contacts retrieved successfully"

​
data
object
​
timestamp
string<date-time>