Get an event by ID
Scope: crm:events.read https://api.alladdin.com/api/v2/events/{eventId}
Retrieves the full details of a single CRM event by its unique identifier.
Parameters
Path parameters
eventId string required
Event ID (24-char hex ObjectId)
Request
import requests
url = "https://api.alladdin.com/api/v2/events/{eventId}"
headers = {
"Authorization": "Bearer YOUR_API_KEY",
"Accept": "application/json",
}
response = requests.get(url, headers=headers)
print(response.json())Responses
Response
{
"id": "507f1f77bcf86cd799439011",
"name": "string",
"contact_id": "string",
"contact_name": "string",
"kind": "string",
"description": "string",
"start_date": "2024-01-15T10:30:00Z",
"end_date": "2024-01-15T10:30:00Z",
"status": 0,
"tags": [
"string"
],
"location": "string",
"lead_id": "string",
"funnel_id": "string",
"user_id": "string",
"created_at": "2024-01-15T10:30:00Z",
"updated_at": "2024-01-15T10:30:00Z"
}Success responses
200 Event found application/json object id string required
Unique identifier of the event
name string required
Event name
contact_id string | null required
Associated contact ID
contact_name string | null required
Contact display name
kind string | null required
Activity type key (e.g. call, meeting, task)
description string | null required
Event description
start_date string<date-time> | null required
Start date in ISO 8601 format
end_date string<date-time> | null required
End date in ISO 8601 format
status integer required
Event status (0 = pending, 1 = completed)
tags[] string[] required
List of tag names
location string | null required
Event location
lead_id string | null required
Associated deal/lead ID
funnel_id string | null required
Associated funnel ID
user_id string | null required
ID of the user assigned to the event
created_at string<date-time> | null required
Creation date in ISO 8601 format
updated_at string<date-time> | null required
Last update date in ISO 8601 format
Error responses
401 Invalid or missing API key application/json 403 Insufficient permissions application/json 404 Event not found application/json 429 Rate limit exceeded application/json