> ## 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 details of a specific event by its ID

## Overview

This endpoint allows you to retrieve the details of a previously created event from Cometly.

## Path Parameters

<ParamField path="event_id" type="string" required>
  The unique identifier of the event to retrieve
</ParamField>

## Response

### Success Response

Returns the event object directly (not wrapped in a `data` property).

<ResponseField name="id" type="string">
  The unique identifier of the event
</ResponseField>

<ResponseField name="profile_id" type="string">
  The identifier of the contact profile associated with this event
</ResponseField>

<ResponseField name="company_id" type="string">
  Your company identifier
</ResponseField>

<ResponseField name="space_id" type="string">
  The space identifier this event belongs to
</ResponseField>

<ResponseField name="event_name" type="string">
  The name of the event (e.g., `purchase`, `custom_event_1`)
</ResponseField>

<ResponseField name="configured_name" type="string">
  The configured name of the event. For custom events (`custom_event_1` through `custom_event_50`), this is the user-configured name. For standard events, this equals `event_name`.
</ResponseField>

<ResponseField name="amount" type="number">
  Transaction amount
</ResponseField>

<ResponseField name="is_upsell" type="boolean">
  Indicates if this is an upsell transaction
</ResponseField>

<ResponseField name="event_time_utc" type="string">
  Timestamp of when the event occurred (UTC)
</ResponseField>

<ResponseField name="order_id" type="string">
  Order identifier
</ResponseField>

<ResponseField name="order_name" type="string">
  Order name or description
</ResponseField>

### Error Response

<ResponseField name="message" type="string">
  Error description explaining what went wrong
</ResponseField>

## Example Requests

<CodeGroup>
  ```bash cURL theme={null}
  curl https://app.cometly.com/public-api/v1/events/evt_123456 \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Accept: application/json" \
    -H "Content-Type: application/json"
  ```

  ```javascript JavaScript theme={null}
  const eventId = 'evt_123456';
  const response = await fetch(`https://app.cometly.com/public-api/v1/events/${eventId}`, {
    method: 'GET',
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY',
      'Accept': 'application/json',
      'Content-Type': 'application/json'
    }
  });

  const data = await response.json();
  ```

  ```php PHP theme={null}
  <?php
  $eventId = 'evt_123456';
  $url = 'https://app.cometly.com/public-api/v1/events/' . $eventId;
  $headers = [
      'Authorization: Bearer YOUR_API_KEY',
      'Accept: application/json',
      'Content-Type: application/json'
  ];

  $ch = curl_init();
  curl_setopt($ch, CURLOPT_URL, $url);
  curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
  curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

  $response = curl_exec($ch);
  curl_close($ch);
  ?>
  ```

  ```python Python theme={null}
  import requests

  event_id = 'evt_123456'
  url = f'https://app.cometly.com/public-api/v1/events/{event_id}'
  headers = {
      'Authorization': 'Bearer YOUR_API_KEY',
      'Accept': 'application/json',
      'Content-Type': 'application/json'
  }

  response = requests.get(url, headers=headers)
  ```
</CodeGroup>

## Status Codes

| Status Code | Description                                                                               |
| ----------- | ----------------------------------------------------------------------------------------- |
| 200         | Event successfully retrieved                                                              |
| 401         | Missing or invalid API key                                                                |
| 403         | API key doesn't have permission or subscription is inactive                               |
| 404         | Event not found                                                                           |
| 422         | Invalid event ID provided                                                                 |
| 429         | Too many requests - rate limit exceeded. See [Rate Limiting](/introduction/rate-limiting) |

## Notes

* **Rate Limit**: This endpoint has a limit of **30 requests per minute** per Space. See [Rate Limiting](/introduction/rate-limiting) for details.