List contacts
GET /v1/contacts
One record per person across waitlist signups, changelog subscribers, feedback and your Stripe customers, matched on normalised email (lowercase, +alias removed, dots ignored on Gmail). Works without Stripe. Each contact’s user_ids are your own user ids known for the person (from identify() with an email, feedback with both, or a paying customer’s metadata): what a notification to them reaches. Free plan: waitlist people only, one page of at most 100 (meta.plan_limited).
Auth: Secret key only.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Query Parameters
Section titled “Query Parameters ”Has an active or past-due subscription.
Waitlist status.
A utm_source or referrer hostname, or direct, referral, stripe.
Part of an email address.
Only people who have granted this consent now, such as email_marketing. waitlist and changelog are built in: on the waitlist and not unsubscribed, and subscribed to the changelog.
name for people who have that detail, or name=value for that value (any case), such as stage=building.
meta.next_cursor from the previous page.
Responses
Section titled “ Responses ”Contacts, with meta.next_cursor and meta.has_more. Each carries details (name to value) and consents (the purposes granted now, built-ins included).
Error envelope. See error.code for the discriminator.
object
object
object
Error envelope. See error.code for the discriminator.