API referenceSegments
Preview a saved segment's matching contacts
GET
Oldest-first keyset page over (created_at, id) of contacts matching the segment's compiled filter.
bearerAuthheader
AuthorizationBearer <token>API key sent as Authorization: Bearer <key>. Looked up by SHA-256
hash (email_core::sha256_hex) against api_keys.hash; revoked
keys and keys belonging to a suspended tenant are rejected. See the
top-level Authentication section for permission levels.
id*stringlimit?integerMax rows to return.
Range
1 <= value <= 100Default
25cursor?stringMatching contacts.
application/json- response
data?array<>next_cursor?string|nullcurl -X GET "https://example.com/v1/segments/string/preview"{ "data": [ { "id": "string", "email": "user@example.com", "status": "subscribed", "attributes": {}, "source": "string", "created_at": 0, "updated_at": 0 } ], "next_cursor": "string"}