get_contact_journey

Returns every touchpoint and conversion for a contact, sorted by time, with an LTV total. Use for “how did this lead get here?” questions or for diagnosing attribution decisions on a real example.

When to use

“Show me the journey for contact 8231.”
“Why was this credited to Facebook?”
Understanding the full first-touch → conversion flow for a real customer.

For aggregated questions about many contacts, use query_contacts_aggregated. For the contact’s basic record, use get_contact.

Parameters

Parameter	Type	Required	Description
`profile_id`	integer	Yes	Numeric profile id.
`hide_direct_touchpoints`	boolean	No	Suppress direct-source touchpoints after the first. Default: `true`.
`format`	string	No	`json` (default), `csv`, or `yaml`.

Output

{
  "profile_id":       8231,
  "name":             "Taylor Swift",
  "first_active_utc": "2026-04-12T13:08:00Z",
  "last_active_utc":  "2026-05-14T19:02:00Z",
  "ltv":              429.50,
  "event_count":      18,
  "events": [
    { "type": "touchpoint",  "event_time_utc": "2026-04-12T13:08:00Z", "source": "facebook_ads", "ad_id": "120203" },
    { "type": "touchpoint",  "event_time_utc": "2026-04-15T09:42:00Z", "source": "google_ads",   "ad_id": "8423001" },
    { "type": "conversion",  "event_time_utc": "2026-04-15T09:55:00Z", "event_name": "lead_generated", "amount": null },
    { "type": "conversion",  "event_time_utc": "2026-05-14T19:02:00Z", "event_name": "purchase",       "amount": 429.50 }
  ]
}

Caveats

Capped at 250 touchpoints + 250 conversions. For contacts with extreme journey lengths, narrow the question rather than asking for the full timeline.

Get Started

Connecting Clients

Tools

Resources

Prompts

When to use

Parameters

Output

Caveats

​When to use

​Parameters

​Output

​Caveats

When to use

Parameters

Output

Caveats