API referenceContacts
List contacts
GET
Newest-first keyset page over (created_at, id).
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.
limit?integerMax rows to return.
Range
1 <= value <= 100Default
25cursor?string"{created_at}:{id}" from a previous page's next_cursor.
status?stringAn unrecognized value is silently dropped (no filter applied), not rejected.
Value in
"subscribed""unsubscribed""cleaned"Contact list.
application/json- response
data?array<>next_cursor?string|nullcurl -X GET "https://example.com/v1/contacts"{ "data": [ { "id": "string", "email": "user@example.com", "status": "subscribed", "attributes": {}, "source": "string", "created_at": 0, "updated_at": 0 } ], "next_cursor": "string"}