> ## 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_event

> Retrieve full detail for a single conversion event by ID.

Returns the complete record for one conversion event, including metadata, touchpoint attribution, and computed fields like `event_url`.

## When to use

* Drilling into a single event after [`list_events`](/mcp/tools/list-events) returns its ID.
* *"What's the full detail for event 8123?"*
* *"Show me the URL and order details for that purchase."*

For bulk listing, use [`list_events`](/mcp/tools/list-events). For aggregated metrics, use [`query_ad_metrics`](/mcp/tools/query-ad-metrics).

## Parameters

| Parameter | Type    | Required | Description                                                   |
| --------- | ------- | -------- | ------------------------------------------------------------- |
| `id`      | integer | Yes      | The numeric ID of the event (returned in `list_events` rows). |

## Example response

```json theme={null}
{
  "id": 8123,
  "event_name": "purchase",
  "configured_name": "Purchase",
  "amount": 89.50,
  "event_time_utc": "2026-05-13T14:22:10Z",
  "event_url": "https://acme.com/checkout/confirmation?order=99812",
  "order_id": "99812",
  "order_name": "Spring Sale — Order #99812",
  "profile_id": 41902,
  "company_id": null,
  "is_upsell": false,
  "touchpoints": [
    {
      "source": "facebook_ads",
      "ad_name": "Spring Sale — Carousel A",
      "adset_name": "Lookalike 1% — US",
      "campaign_name": "Spring 2026 — Acquisition",
      "account_name": "Acme Ad Account",
      "event_time_utc": "2026-05-13T13:58:22Z"
    }
  ]
}
```

## Caveats

* Returns 404 (`[not_found]`) if no event with that ID exists in the current Space. The model is told not to retry on `not_found`.
* The `configured_name` field returns the user-defined label for custom events (`custom_event_9` → "Demo Submission") and equals `event_name` for standard events.
