Skip to main content

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.

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 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. For aggregated metrics, use query_ad_metrics.

​
Parameters

ParameterTypeRequiredDescription
idintegerYesThe numeric ID of the event (returned in list_events rows).

​
Example response

{
  "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.