List reference lifecycle events

Returns the lifecycle event log for a given reference id.

The lifecycle log is an append-only record of significant events for a reference — creation, deactivation, reactivation, extraction attempts, reference updates, and estimated event changes. Events are retained for 18 months.

Pagination is cursor-based: pass the returned next_cursor as the cursor query parameter to fetch the next page. When there are no further results, next_cursor is null.

Related docs:

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

Id of a created reference

Query Params
integer
1 to 500
Defaults to 50

Maximum events to return per page (1-500).

string

Opaque cursor token from a previous response's next_cursor.

string

Comma-separated list of event types to filter on. Each value must be a valid ReferenceEventType.

date-time

Filter events with occurred_at >= from.

date-time

Filter events with occurred_at <= to.

string
enum
Defaults to asc

Sort order on occurred_at.

Allowed:
Responses

Language
Credentials
Header
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json