> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cometly.com/llms.txt
> Use this file to discover all available pages before exploring further.

# get_contact_journey

> Full chronological timeline for a single contact — touchpoints interleaved with conversions.

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`](/mcp/tools/query-contacts-aggregated). For the contact's basic record, use [`get_contact`](/mcp/tools/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

```json theme={null}
{
  "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.