calendarquery

Calendarquery is a generic term for a query interface or API designed to retrieve calendar-related data from calendar stores. It enables applications to request events, RSVP statuses, reminders, and related metadata within specified temporal and structural constraints. Calendar queries may operate over diverse data sources, including local ICS files, CalDAV servers, and cloud calendar services, and are used to support scheduling, availability checks, and analytics.

Typical features include time-range filtering (start and end times), recurrence expansion to list instances of repeating events, filtering by calendar, attendee, location, or free/busy status, and support for privacy controls. Many implementations model events with properties such as start, end, duration, summary, description, attendees, and alarms, and use time zones to ensure correct interpretation across regions.

Query languages commonly provide SQL-like filters or a dedicated API for composing constraints. Standard formats include iCalendar (RFC 5545) representations and CalDAV's calendar-query REPORT requests, while modern services expose REST or GraphQL endpoints with parameters for calendar IDs, date ranges, and filters. Performance considerations include indexing on start/end times, supporting partial expansion of recurring events, and efficient synchronization with servers.

Common use cases include finding meetings within a date range, checking availability for scheduling, generating user calendars for display, or extracting event statistics. Calendarquery-enabled APIs are foundational to calendar clients, scheduling tools, and productivity applications.