---
title: "List on-calls with flexible filters"
method: GET
path: "/on-calls"
tags: ["On-Calls"]
---

# List on-calls with flexible filters

`GET /on-calls`

## Query parameters

- `policies` number
- `policy-levels` string
- `schedules` number
- `users` number
- `expand` string
- `from` string
- `until` string
- `timezone` string
- `start-index` number
- `max-results` number

## Response `200`

returns a list of on-call objects for the searched window

- OnCall[]
  - `user` User
    - `id` integer
    - `firstName` string, required
    - `lastName` string, required
    - `email` string, required
    - `timezone` 'Europe/Berlin' | 'America/New_York' | 'America/Los_Angeles' | 'Asia/Istanbul'
    - `position` string
    - `department` string
    - `avatarUrl` string
    - `language` 'de' | 'en'
    - `region` 'DE' | 'GB' | 'CH' | 'CN' | 'IN' | 'US' | 'FR' | 'ES' | 'CA' | 'IE'
    - `role` 'STAKEHOLDER' | 'GUEST' | 'RESPONDER' | 'USER' | 'ADMIN'
    - `shiftColor` string — Optional hex-color code for the user's shifts in schedules calendars
    - `mutedUntil` string, date-time — Date in ISO-8601
    - `createdAt` string, date-time — Date in ISO-8601
    - `updatedAt` string, date-time — Date in ISO-8601
  - `escalationPolicy` EscalationPolicy
    - `id` integer
    - `name` string, required
    - `escalationRules` EscalationRule[], required
      - `escalationTimeout` integer, required
      - `user` object — This field (type: User) is deprecated, please use 'users' instead
        - `id` number
      - `schedule` object — This field (type: Schedule) is deprecated, please use 'schedules' instead
        - `id` number
      - `team` object — This field (type: Team) is deprecated, please use 'teams' instead
        - `id` number
      - `users` UserRel[]
        - `id` integer, required
        - `firstName` string
        - `lastName` string
      - `schedules` ScheduleRel[]
        - `id` integer
        - `name` string
        - `type` 'STATIC' | 'RECURRING'
      - `teams` TeamRel[]
        - `id` integer
        - `name` string
    - `teams` TeamRel[]
      - `id` integer
      - `name` string
    - `repeating` boolean
    - `frequency` integer
    - `delayMin` integer
    - `routingKey` string — optional
  - `schedule` ScheduleRel
    - `id` integer
    - `name` string
    - `type` 'STATIC' | 'RECURRING'
  - `start` string, date-time
  - `end` string, date-time
  - `escalationLevel` number

---

[API](https://skmtc.dev/ilert/apis/ilert-rest-api.md) · [All operations](https://skmtc.dev/ilert/apis/ilert-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ilert/ilert-rest-api/revisions/cb7d5a5f9ab8/schema)