List Contacts in Segment

Retrieve a paginated list of contacts belonging to a specific segment.

---

Endpoint

GET https://api.campaignlark.com/v1/segments/:segment_id/contacts

---

Path Parameters

Parameter	Type	Required	Description
segment_id	integer	required	The ID of the segment to retrieve contacts for.

---

Query Parameters

Parameter	Type	Required	Description
page	integer	optional	Page number for pagination. Defaults to 1.
limit	integer	optional	Number of contacts per page. Defaults to 50.

---

Sample Request

GET https://api.campaignlark.com/v1/segments/1/contacts?page=1&limit=50

---

Response

Success — 200 OK

{
  "data": {
    "contacts": [
      {
        "id": "abc123",
        "fields": {
          "email_address": "user@example.com",
          "first_name": "John"
        },
        "tags": [
          {
            "id": 1,
            "name": "VIP"
          }
        ],
        "status": "SUBSCRIBED",
        "score": 0,
        "created_at": "2026-01-15T10:30:00Z",
        "updated_at": "2026-04-09T02:00:00Z",
        "last_opened_at": "2026-04-08T14:00:00Z",
        "last_clicked_at": null
      }
    ],
    "pagination": {
      "current_page": 1,
      "per_page": 50,
      "total_pages": 10,
      "total_count": 500
    }
  }
}

Contact Object Fields

Field	Type	Description
id	string	Unique contact ID.
fields	object	Key-value map of contact field values, keyed by merge_tag.
tags	array	Tags assigned to the contact. Each item has id (integer) and name (string).
status	string	Contact status. One of SUBSCRIBED, UNSUBSCRIBED, UNCONFIRMED, BOUNCED, COMPLAINED.
score	integer	Contact engagement score.
created_at	string	RFC 3339 timestamp of contact creation.
updated_at	string	RFC 3339 timestamp of last update.
last_opened_at	string | null	RFC 3339 timestamp of the last email open.
last_clicked_at	string | null	RFC 3339 timestamp of the last link click.

Pagination Object

Field	Type	Description
current_page	integer	The current page number.
per_page	integer	Number of items per page.
total_pages	integer	Total number of pages.
total_count	integer	Total number of contacts in the segment.