Skip to main content
GET
List person steps

Authorizations

Authorization
string
header
required

Path Parameters

person_id
string
required

The Extole unique profile identifier of this user at Extole.

Query Parameters

names
string[]
containers
string[]
campaign_ids
string[]
programs
string[]
journey_names
string[]
is_primary
boolean
data_keys
string[]
event_ids
string[]
cause_event_ids
string[]
root_event_ids
string[]
offset
integer<int32>
limit
integer<int32>
journey_key_names
string[]
journey_key_values
string[]

Response

Successful response

campaign_id
string
required

Extole campaign id associated with this step. Absent when no campaign is linked.

cause_event_id
string
required

Id of the direct cause event for this step.

container
string
required

Campaign container the step belongs to.

created_date
string
required

RFC 3339 or RFC 9557 date-time with a numeric UTC offset and an optional IANA time-zone suffix in square brackets. Precision up to milliseconds.

Pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d{1,3})?(Z|[+-](?:[01][0-9]|2[0-3]):[0-5][0-9])(\[[^\]]+\])?$
Example:

"2025-10-24T02:00:00-07:00"

data
object
required

Named data parameters attached to this step.

event_date
string
required

RFC 3339 or RFC 9557 date-time with a numeric UTC offset and an optional IANA time-zone suffix in square brackets. Precision up to milliseconds.

Pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d{1,3})?(Z|[+-](?:[01][0-9]|2[0-3]):[0-5][0-9])(\[[^\]]+\])?$
Example:

"2025-10-24T02:00:00-07:00"

event_id
string
required

Extole event id that triggered this step.

id
string
required
read-only

Extole-assigned unique identifier for this step.

is_primary
boolean
required

Whether this is the primary (first qualifying) step for this event type in the journey.

journey_key
object
required
journey_name
string
required

Journey name associated with this step. Absent for global-scope steps.

name
string
required

Name of the event type that created this step (e.g. purchase, signup).

program
string
required

Program key associated with this step. Absent when no program context exists.

quality
enum<string>
required

Quality classification of the step (GOOD or BAD).

Available options:
HIGH,
LOW,
NONE
root_event_id
string
required

Id of the root event that initiated the chain leading to this step.

scope
enum<string>
required

Scope of the step (GLOBAL or JOURNEY).

Available options:
CLIENT,
PRIVATE,
PUBLIC
updated_date
string
required

RFC 3339 or RFC 9557 date-time with a numeric UTC offset and an optional IANA time-zone suffix in square brackets. Precision up to milliseconds.

Pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d{1,3})?(Z|[+-](?:[01][0-9]|2[0-3]):[0-5][0-9])(\[[^\]]+\])?$
Example:

"2025-10-24T02:00:00-07:00"