Skip to main content
GET
List people
To list everyone identified in a time window, add visited_since (and optionally visited_until); include_page_views=true adds the pages each person viewed in that window. This mode allows limit up to 250 and orders people by when their record last changed, so follow nextCursor to the end and deduplicate by id. See Partners for details. Each person includes stored acquisition attribution: referrer, utmSource, utmMedium, utmCampaign, utmTerm, utmContent, and campaignHistory, alongside trafficType and adPlatform. Missing scalar values are null; missing history is []. These fields may describe an earlier campaign rather than the latest visit. Reading them does not collect or generate missing attribution.

Authorizations

X-API-Key
string
header
required

API key in format: mk_live_{40 hex chars}

Query Parameters

limit
integer
default:50

Number of records per page

Required range: 1 <= x <= 100
cursor
string

Pagination cursor from the previous response's nextCursor

since
string<date-time>

Only return records with lastSeen after this ISO 8601 date

domain
string

Partner accounts only. Restrict results to one tracked client domain. Matches subdomains too, so acme.com includes app.acme.com. A domain-scoped API key cannot use this to reach beyond its own scope.

client_ref
string

Partner accounts only. Restrict results to one client by the reference label set on its tracked domains. Case-insensitive. If a client has several domains registered, all of them are included.

domain_group_id
string

Partner domain group ID. Matches exact member hostnames (www aliases normalized), including any member site the person has visited. Intersects domain, client_ref, and the key's scope; never grants extra access. Empty group returns zero matches; missing/foreign group returns 404; invalid ID returns 400. Keep this filter when following pagination cursors.

Pattern: ^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$
hot_leads_only
boolean

Filter to only ICP-matched hot leads

path
string

Return only people who viewed at least one of these pages anywhere in their journey, not just the page they were identified on. Comma-separate for several. Paths are matched case-insensitively and ignore the host, query string and trailing slash, so /Pricing/ and https://acme.com/pricing?utm_source=x both mean /pricing. An empty or invalid value returns 400 validation_error.

Example:

"/pricing,/demo"

email_status
string

Return only people with at least one address in the given deliverability statuses. Comma-separate for several. Valid values: valid, invalid, catch-all, unknown, spamtrap, abuse, do_not_mail — anything else returns 400. People with no email address at all never match, including on unknown.

Example:

"valid,catch-all"

exclude_bad_emails
boolean
default:false

Blank any email field whose address is confirmed undeliverable (invalid, spamtrap, abuse, do_not_mail), matching what a verified CSV export does. The person is still returned, and emailVerification still reports the status, so you can see why a field came back empty. Addresses that are catch-all, unknown, or not yet verified are kept. Off by default — it empties fields existing integrations already read.

visited_since
string<date-time>

Return only people with an identified page view at or after this time (timezone required). Switches to visit-window mode: results ordered by record update time, limit up to 250, its own cursor. A person updated while paging can appear on a later page again; deduplicate by id.

visited_until
string<date-time>

Exclusive end of the visit window; default now. Requires visited_since. Window at most 31 days.

include_page_views
boolean
default:false

With visited_since, add pageViews (in the window, oldest first, up to 200) and pageViewsTruncated to each person.

Response

List of people

data
object[]
pagination
object
window
object

Present in visit-window mode