GET
/
api
/
v1
/
calendar
/
events
/
{event_id}
{
  "id": 123,
  "uuid": "<string>",
  "title": "<string>",
  "description": "<string>",
  "event_type": "<string>",
  "event_type_display": "<string>",
  "status": "<string>",
  "status_display": "<string>",
  "start_time": "<string>",
  "end_time": "<string>",
  "duration_minutes": 123,
  "location": "<string>",
  "has_video_conference": true,
  "video_conference_url": "<string>",
  "video_conference_provider": "<string>",
  "created_by_ai_agent": true,
  "is_reminder_enabled": true,
  "remind_before_minutes": 123,
  "created_at": "<string>",
  "updated_at": "<string>",
  "customer": {
    "name": "<string>",
    "email": "<string>",
    "phone": "<string>",
    "notes": "<string>"
  },
  "ai_agent": {
    "id": 123,
    "name": "<string>",
    "assistant_id": "<string>"
  },
  "team": {
    "id": 123,
    "name": "<string>"
  },
  "external_calendars": {
    "google": "<string>",
    "outlook": "<string>",
    "gohighlevel": "<string>"
  },
  "ics_url": "<string>",
  "error": "<string>",
  "message": "<string>"
}

Get detailed information about a specific calendar event.

​
Path Parameters

​
event_id
string
required

ID or UUID of the event to retrieve.

​
Response

​
id
integer

Event ID.

​
uuid
string

Event UUID.

​
title
string

Event title.

​
description
string

Event description.

​
event_type
string

Type of event. One of: meeting, appointment, busy, voice_call, video_call.

​
event_type_display
string

Human-readable event type.

​
status
string

Event status. One of: scheduled, confirmed, cancelled, completed, no_show.

​
status_display
string

Human-readable status.

​
start_time
string

Event start time.

​
end_time
string

Event end time.

​
duration_minutes
integer

Event duration in minutes.

​
location
string

Event location.

​
has_video_conference
boolean

Whether the event has video conferencing enabled.

​
video_conference_url
string

URL for video conferencing.

​
video_conference_provider
string

Provider of video conferencing (e.g., Zoom, Google Meet, etc.).

​
created_by_ai_agent
boolean

Whether the event was created by an AI agent.

​
is_reminder_enabled
boolean

Whether reminders are enabled for this event.

​
remind_before_minutes
integer

How many minutes before the event to send a reminder.

​
created_at
string

When the event was created.

​
updated_at
string

When the event was last updated.

​
customer
object

Customer information.

​
ai_agent
object

AI agent information (if event was created by an agent).

​
team
object

Team information.

​
external_calendars
object

External calendar IDs.

​
ics_url
string

URL to download ICS file for this event.

​
Example Request

curl -X GET 'https://api.klen.ai/api/v1/calendar/events/123' \
  -H 'Authorization: Bearer klen_YOUR_API_KEY'

Or using the UUID:

curl -X GET 'https://api.klen.ai/api/v1/calendar/events/f47ac10b-58cc-4372-a567-0e02b2c3d479' \
  -H 'Authorization: Bearer klen_YOUR_API_KEY'

​
Example Response

{
  "id": 123,
  "uuid": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "title": "Client Meeting",
  "description": "Discuss project requirements and timeline",
  "event_type": "meeting",
  "event_type_display": "Meeting",
  "status": "confirmed",
  "status_display": "Confirmed",
  "start_time": "2025-05-01T14:00:00.000Z",
  "end_time": "2025-05-01T15:00:00.000Z",
  "duration_minutes": 60,
  "location": "Conference Room A",
  "has_video_conference": true,
  "video_conference_url": "https://meet.google.com/abc-defg-hij",
  "video_conference_provider": "Google Meet",
  "created_by_ai_agent": true,
  "is_reminder_enabled": true,
  "remind_before_minutes": 30,
  "created_at": "2025-04-25T10:15:30.000Z",
  "updated_at": "2025-04-25T10:15:30.000Z",
  "customer": {
    "name": "John Smith",
    "email": "[email protected]",
    "phone": "+15551234567",
    "notes": "Prefers afternoon meetings"
  },
  "ai_agent": {
    "id": 42,
    "name": "Meeting Scheduler",
    "assistant_id": "asst_01234567890"
  },
  "team": {
    "id": 5,
    "name": "Sales Team"
  },
  "external_calendars": {
    "google": "google_event_id_123",
    "outlook": "outlook_event_id_456"
  },
  "ics_url": "/calendar/event/f47ac10b-58cc-4372-a567-0e02b2c3d479/calendar.ics"
}

​
Error Responses

​
error
string

Error code.

​
message
string

Error message.

​
Not Found (404)

{
  "error": "not_found",
  "message": "Event not found or you do not have access"
}

​
Unauthorized (401)

{
  "error": "authentication_required",
  "message": "API key is required"
}

​
Permission Denied (403)

{
  "error": "permission_denied",
  "message": "This API key does not have can_read_calendar permission"
}

​
Server Error (500)

{
  "error": "server_error",
  "message": "An unexpected server error occurred"
}