get_contact_journey - Cometly API Docs

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.