LOOMAL
SDK / API ReferenceCalendar

List Events

List calendar events with optional date filtering

Scope: calendar:read

List events on the identity's calendar. Supports date-range filtering via from and to (ISO 8601).

Request

import { Loomal } from "@loomal/sdk";

const loomal = new Loomal({ apiKey: process.env.LOOMAL_API_KEY! });
const { events, count } = await loomal.calendar.list({
  limit: 50,
  from: "2026-04-01T00:00:00Z",
  to: "2026-05-01T00:00:00Z",
});
import os
from loomal import Loomal

loomal = Loomal(api_key=os.environ["LOOMAL_API_KEY"])
result = loomal.calendar.list(
    limit=50,
    from_date="2026-04-01T00:00:00Z",
    to_date="2026-05-01T00:00:00Z",
)
loomal calendar list --limit 50 --from 2026-04-01T00:00:00Z --to 2026-05-01T00:00:00Z
calendar.list(limit=50, from="2026-04-01T00:00:00Z", to="2026-05-01T00:00:00Z")

Available through @loomal/mcp — see MCP setup.

curl "https://api.loomal.ai/v0/calendar?limit=50&from=2026-04-01T00:00:00Z&to=2026-05-01T00:00:00Z" \
  -H "Authorization: Bearer loid-your-api-key"

Query Parameters

ParamTypeDefaultDescription
limitnumber50Max results (max 100)
fromstringFilter: events starting from (ISO 8601)
tostringFilter: events starting before (ISO 8601)

Response 200

{
  "events": [
    {
      "eventId": "evt_abc123",
      "title": "Team Sync",
      "description": "Weekly standup",
      "startAt": "2026-04-07T10:00:00.000Z",
      "endAt": "2026-04-07T11:00:00.000Z",
      "isAllDay": false,
      "location": "Zoom"
    }
  ],
  "count": 1
}

Calendar list uses date-range filtering (from/to), not cursor-based pagination.

On this page