Skip to content

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. Free plan: waitlist people only, one page of at most 100 (meta.plan_limited).

Auth: Secret key only.

paying
boolean

Has an active or past-due subscription.

has_feedback
boolean
status
string
Allowed values: waiting invited unsubscribed

Waitlist status.

source
string

A utm_source or referrer hostname, or direct, referral, stripe.

stage
string
Allowed values: potential in_talks customer recurring not_a_fit inactive
q
string

Part of an email address.

limit
integer
default: 20 >= 1 <= 100
cursor
string

meta.next_cursor from the previous page.

Contacts, with meta.next_cursor and meta.has_more

Error envelope. See error.code for the discriminator.

object
data
required
null
error
required
object
code
required
string
message
required
string
remediation
required
string
doc_url
string format: uri
param
string
request_id
string
meta
object
key
additional properties

Error envelope. See error.code for the discriminator.

object
data
required
null
error
required
object
code
required
string
message
required
string
remediation
required
string
doc_url
string format: uri
param
string
request_id
string
meta
object
key
additional properties