Skip to main content
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"
}