---
title: "Get all events for the caller user."
method: GET
path: "/integrations/calendar/events"
tags: ["calendar"]
---

# Get all events for the caller user.

`GET /integrations/calendar/events`

## Request

- Base URL: `https://localhost:8080/api/v9`
- URL: `https://localhost:8080/api/v9/integrations/calendar/events`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/toggl/apis/toggl-api/docs/integrations/calendar/events/get.ts> (a function with typed inputs; its response is checked against the schema)

Get all events from selected calendars for the caller user. This endpoint will only return events if events were fetched from provider before the request is made. Check which is the endpoint for the events.

## Query parameters

- `start_date` string, required
- `end_date` string, required
- `limit` string
- `page_token` string

## Response `200`

Events successfully retrieved

- HandlercalendarEventsResponse
  - `events` ModelsEvent[]
    - `all_day` boolean
    - `background` string
    - `calendar_event_id` integer
    - `calendar_id` integer
    - `end_time` string
    - `external_id` string
    - `foreground` string
    - `html_link` string
    - `ical_uid` string: This is an unique ID used to avoid duplicate events when getting information from multiple sources. E. G. the mobile may get calendar events without BE integration, so they should be able to tell if an event is repeated.
    - `start_time` string
    - `title` string
    - `updated` string
  - `next_page_token` string

## Other responses

- `400`: Possible error messages: * start\_date has invalid format * end\_date has invalid format * start\_date should not be empty * end\_date should not be empty * start\_date should come before end\_date * User {user\_id} has an invalid timezone * {date} has invalid format
- `500`: Internal Server Error

---

[API](https://skmtc.dev/toggl/apis/toggl-api.md) - [All operations](https://skmtc.dev/toggl/apis/toggl-api/llms.txt) - [OpenAPI document](https://skmtc.dev/toggl/apis/toggl-api/revisions/3085aee16990?raw)