Error
List calendar events
Fetch calendar events for sync jobs, dashboards, and reporting tools. Requires the calendar:read scope.
GET
Error
Returns calendar events for the authenticated key. Use this endpoint for sync jobs, dashboards, and reporting tools that need read-only calendar data.
Required API key scope:
calendar:read.Query parameters
string
ISO 8601 datetime for the beginning of the event window. If omitted, Pharen uses a bounded default range.
string
ISO 8601 datetime for the end of the event window. Must be after
range_start.string
Team UUID for team-scoped keys. Workspace-wide keys can omit this unless the integration is intentionally targeting one team.
Response
string
Event UUID.
string
UUID of the calendar that owns the event.
string
Event title.
string
Event start time as an ISO 8601 datetime.
string
Event end time as an ISO 8601 datetime.
boolean
Whether the event spans the full day.
string
Event location, if set.
string
Meeting or conference URL, if set.
array
Attendee objects associated with the event.
Authorizations
Paste your Pharen API key without the Bearer prefix.
Query Parameters
ISO 8601 datetime for the beginning of the event window.
Example:
"2026-07-01T00:00:00Z"
ISO 8601 datetime for the end of the event window. Must be after range_start.
Example:
"2026-07-31T23:59:59Z"
Team UUID for team-scoped keys.
Example:
"1f5e2d4c-7a5b-45db-b61a-b7d42f3f94cc"