Skip to main content
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

ParameterTypeRequiredDescription
profile_idintegerYesNumeric profile id.
hide_direct_touchpointsbooleanNoSuppress direct-source touchpoints after the first. Default: true.
formatstringNojson (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.