Skip to main content
GET
{baseUrl}
/
api
/
calendar
/
events
/
Error
A valid request URL is required to generate request examples
{
  "data": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "calendar_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "title": "Quarterly planning",
      "starts_at": "2023-11-07T05:31:56Z",
      "ends_at": "2023-11-07T05:31:56Z",
      "is_all_day": true,
      "location": "<string>",
      "conference_url": "<string>",
      "attendees": [
        {
          "email": "jsmith@example.com",
          "name": "<string>"
        }
      ]
    }
  ],
  "total": 12,
  "page": 1,
  "per_page": 20
}
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

​
range_start
string
ISO 8601 datetime for the beginning of the event window. If omitted, Pharen uses a bounded default range.
​
range_end
string
ISO 8601 datetime for the end of the event window. Must be after range_start.
​
team_id
string
Team UUID for team-scoped keys. Workspace-wide keys can omit this unless the integration is intentionally targeting one team.

​
Response

​
id
string
Event UUID.
​
calendar_id
string
UUID of the calendar that owns the event.
​
title
string
Event title.
​
starts_at
string
Event start time as an ISO 8601 datetime.
​
ends_at
string
Event end time as an ISO 8601 datetime.
​
is_all_day
boolean
Whether the event spans the full day.
​
location
string
Event location, if set.
​
conference_url
string
Meeting or conference URL, if set.
​
attendees
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