List segment contacts
Segment
List Segment Contacts
Retrieve a paginated list of a segment’s materialized contacts (the mapping created at segment-build time), with optional mobile number search.
GET
List segment contacts
Use this endpoint to retrieve a paginated list of a segment’s contacts — the materialized contact mapping created when the segment was built, not a live re-evaluation of its filter.
Endpoint
GET/segment/contacts
Authentication: Required (workspace auth)
Query Parameters
Response
Behavior
- Reads the segment’s materialized contact mapping (
segment_contacts, status = active) joined to the underlying audience contacts — the exact set a connected campaign would dial. The segment’s filter is not re-evaluated here. - Dynamic columns come from the parent audience’s saved input variables (stable order), plus any extra input keys found on this page’s contacts. Phone-number aliases (
mobile_no,mobile,phone,phone_no,phone_number) are skipped sincemobile_noalready has its own column. mobile_nois masked when the workspace’s company has phone number masking enabled.- As a side effect, the segment’s cached
total_contactsis refreshed to match the live count of materialized contacts if it had drifted.
Error Cases
Example cURL
Headers
API token for authentication
Query Parameters
Segment identifier
Page number (default: 1)
Records per page (default: 10)
Partial mobile number search (LIKE)

