Skip to main content
GET
List a contact's activity

Authorizations

Authorization
string
header
required

Send either an API token or an OAuth access token as Authorization: Bearer <token>. See the Authentication page for details.

Headers

Privy-Account-Id
string

Target a subaccount instead of the main connected account. Pass a subaccount id from get_account's subaccounts list. Only direct subaccounts of the connected account are reachable — omit this for the main account itself.

Path Parameters

id
string
required

The contact's unique identifier (returned as id in contact responses). Ids are opaque cus_-prefixed strings — a numeric id from a Privy dashboard URL is not a valid API id and will 404; list contacts, or look the contact up by ?email= or ?phone_number=, instead.

Query Parameters

type
string

Only return events of this type. Any type value a row carries is accepted (including names a merchant's own integration sent through the events ingest), so a type read off the timeline always filters. Common values: customer-subscribed, email-sent, email-delivered, email-opened, email-clicked, text-message-sent, text-message-delivered, view, new-session, redemption, signup, sms-signup, order-created, checkout-started, customer-tag-added, customer-tag-removed.

occurred_after
string

Only events after this instant (exclusive). ISO 8601 datetime or date. Defaults to 24 months before occurred_before — 24 months ago when neither bound is given.

occurred_before
string

Only events before this instant (exclusive). ISO 8601 datetime or date. Defaults to now.

page
integer
default:1

Page number (starts at 1).

Required range: x >= 1
per_page
integer
default:40

Number of results per page. Values outside 10–100 are clamped to the nearest bound.

Required range: 10 <= x <= 100

Response

A paginated list of the contact's events, newest first.

data
object[]
note
string

Present only when the account's plan limits the timeline to signup events.

pagination
object