---
title: "get calendar with it events in time period"
method: GET
path: "/v2/scheduler/calendars/{calendar-id}/events"
tags: ["ICS Calendar Rest Services for Metricool calendar (scheduler)"]
---

# get calendar with it events in time period

`GET /v2/scheduler/calendars/{calendar-id}/events`

## Request

- Base URL: `https://app.metricool.com/api`
- URL: `https://app.metricool.com/api/v2/scheduler/calendars/{calendar-id}/events`
- Auth: none declared

## Path parameters

- `calendar-id` integer, required

## Query parameters

- `initDate` string, required
- `endDate` string, required
- `timeZone` string, required

## Response `200`

Ok

- JsonOkResponseAllEventsInLimitedTimeInOneCalendar
  - `metadata` object
  - `page` JsonPaging
    - `next` string
  - `data` AllEventsInLimitedTimeInOneCalendar
    - `calendar-id` integer: Calendar id
    - `calendar-name` string: Calendar name
    - `start-date` DateTimeInfo
      - `dateTime` string, required: Local Date-time represented with a certain timezone
      - `timezone` string: Timezone applied to the datetime
    - `end-date` DateTimeInfo
      - `dateTime` string, required: Local Date-time represented with a certain timezone
      - `timezone` string: Timezone applied to the datetime
    - `events-all-day` AtomicEventWithInitAndEndOneTime[]: Events all day
      - `eventName` string: Event name
      - `eventDescription` string: Event description
      - `eventInit` DateTimeInfo
        - `dateTime` string, required: Local Date-time represented with a certain timezone
        - `timezone` string: Timezone applied to the datetime
      - `eventEnd` DateTimeInfo
        - `dateTime` string, required: Local Date-time represented with a certain timezone
        - `timezone` string: Timezone applied to the datetime
      - `uid` string
    - `events-by-hour` AtomicEventWithInitAndEndOneTime[]: Events with init hour and end hour
      - `eventName` string: Event name
      - `eventDescription` string: Event description
      - `eventInit` DateTimeInfo
        - `dateTime` string, required: Local Date-time represented with a certain timezone
        - `timezone` string: Timezone applied to the datetime
      - `eventEnd` DateTimeInfo
        - `dateTime` string, required: Local Date-time represented with a certain timezone
        - `timezone` string: Timezone applied to the datetime
      - `uid` string

## Other responses

- `204`: Not content
- `400`: Bad request
- `403`: Forbidden
- `500`: Internal server error

---

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