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

**event\_id** `string` *required*

The unique identifier of the event to retrieve

## Response

### Success Response

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

**id** `string`

The unique identifier of the event

**profile\_id** `string`

The identifier of the contact profile associated with this event

**company\_id** `string`

Your company identifier

**space\_id** `string`

The space identifier this event belongs to

**event\_name** `string`

The name of the event (e.g., `purchase`, `custom_event_1`)

**configured\_name** `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`.

**amount** `number`

Transaction amount

**is\_upsell** `boolean`

Indicates if this is an upsell transaction

**event\_time\_utc** `string`

Timestamp of when the event occurred (UTC)

**order\_id** `string`

Order identifier

**order\_name** `string`

Order name or description

### Error Response

**message** `string`

Error description explaining what went wrong

## Example Requests

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

```javascript JavaScript theme={null}
const eventId = '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 = '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 = '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)
```

## 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](https://docs.cometly.com/introduction/rate-limiting.md) |

## Notes

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.