Get Calendar Event Details

Retrieve detailed information about a specific calendar event

GET /api/v1/calendar/events/{event_id}

Get Calendar Event Details

cURL

curl --request GET \
  --url https://api.example.com/api/v1/calendar/events/{event_id}

200

{
  "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.

Show Customer Details

name · string

Customer name.

email · string

Customer email.

phone · string

Customer phone number.

notes · string

Customer notes.

ai_agent · object

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

Show AI Agent Details

id · integer

Agent ID.

name · string

Agent name.

assistant_id · string

Assistant ID from Vapi.

team · object

Team information.

Show Team Details

id · integer

Team ID.

name · string

Team name.

external_calendars · object

External calendar IDs.

Show External Calendar Details

google · string

Google Calendar event ID.

outlook · string

Outlook Calendar event ID.

gohighlevel · string

GoHighLevel Calendar event ID.

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": "[e-mail]",
    "phone": "[phone]",
    "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"
}