Skip to main content
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

Authorization
string
header
default:phk_your_api_key
required

Paste your Pharen API key without the Bearer prefix.

Query Parameters

range_start
string<date-time>

ISO 8601 datetime for the beginning of the event window.

Example:

"2026-07-01T00:00:00Z"

range_end
string<date-time>

ISO 8601 datetime for the end of the event window. Must be after range_start.

Example:

"2026-07-31T23:59:59Z"

team_id
string<uuid>

Team UUID for team-scoped keys.

Example:

"1f5e2d4c-7a5b-45db-b61a-b7d42f3f94cc"

Response

Calendar events returned.

data
object[]
total
integer
Example:

12

page
integer
Example:

1

per_page
integer
Example:

20