Skip to main content
GET
/
api
/
v1
/
calendar
/
events
List Events
curl --request GET \
  --url https://api.example.com/api/v1/calendar/events
{
  "id": "<string>",
  "title": "<string>",
  "description": "<string>",
  "location": "<string>",
  "start_at": "<string>",
  "end_at": "<string>",
  "all_day": true,
  "status": "<string>",
  "source": "<string>",
  "attendees": [
    {}
  ],
  "is_recurring": true
}

​
List Calendar Events

Returns a paginated list of calendar events for the authenticated user.

​
Authentication

Requires a valid user JWT token.

​
Query Parameters

​
start
string
Start of date range (RFC 3339 format).
​
end
string
End of date range (RFC 3339 format).

​
Response

Returns an array of calendar event objects:
​
id
string
UUID of the event.
​
title
string
Event title.
​
description
string
Event description (nullable).
​
location
string
Event location (nullable).
​
start_at
string
Start time (RFC 3339).
​
end_at
string
End time (RFC 3339).
​
all_day
boolean
Whether it’s an all-day event.
​
status
string
"confirmed" or "pending".
​
source
string
Origin: "user", "agent", "external_request", or "system".
​
attendees
array
List of attendees.
​
is_recurring
boolean
Whether the event recurs.

​
Example

curl "https://api.ama2.me/api/v1/calendar/events?start=2026-04-01T00:00:00Z&end=2026-04-30T23:59:59Z" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"