---
title: "Get oncall information for a user"
method: GET
path: "/oncall/user"
tags: ["Oncall Rosters"]
---

# Get oncall information for a user

`GET /oncall/user`

## Query parameters

- `userId` string, required
- `activeShifts` boolean
- `upcomingShifts` integer
- `pastShifts` integer

## Response `200`

OK

- GetUserOncallInformationResponseBody
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `data` UserOncallInformation, required
    - `activeShifts` OncallShift[], required
      - `attributes` OncallShiftAttributes, required
        - `endAt` string, date-time, required
        - `primaryShift` OncallShift, required — recursive
        - `role` string, required
        - `roster` OncallRoster, required
          - `attributes` OncallRosterAttributes, required
            - `handoverTemplateId` string, required
            - `name` string, required
            - `schedules` OncallSchedule[], required
              - …
            - `slug` string, required
          - `id` string, required
        - `startAt` string, date-time, required
        - `user` User, required
          - `attributes` UserAttributes, required
            - `email` string, required
            - `name` string, required
            - `organizationRole` 'admin' | 'member', required
          - `id` string, required
      - `id` string, required
    - `pastShifts` OncallShift[], required
      - `attributes` OncallShiftAttributes, required
        - `endAt` string, date-time, required
        - `primaryShift` OncallShift, required — recursive
        - `role` string, required
        - `roster` OncallRoster, required
          - `attributes` OncallRosterAttributes, required
            - `handoverTemplateId` string, required
            - `name` string, required
            - `schedules` OncallSchedule[], required
              - …
            - `slug` string, required
          - `id` string, required
        - `startAt` string, date-time, required
        - `user` User, required
          - `attributes` UserAttributes, required
            - `email` string, required
            - `name` string, required
            - `organizationRole` 'admin' | 'member', required
          - `id` string, required
      - `id` string, required
    - `rosters` OncallRoster[], required
      - `attributes` OncallRosterAttributes, required
        - `handoverTemplateId` string, required
        - `name` string, required
        - `schedules` OncallSchedule[], required
          - `attributes` OncallScheduleAttributes, required
            - `description` string, required
            - `participants` OncallScheduleParticipant[], required
              - …
            - `roster` OncallRoster, required — recursive
            - `timezone` string, required
          - `id` string, required
        - `slug` string, required
      - `id` string, required
    - `upcomingShifts` OncallShift[], required
      - `attributes` OncallShiftAttributes, required
        - `endAt` string, date-time, required
        - `primaryShift` OncallShift, required — recursive
        - `role` string, required
        - `roster` OncallRoster, required
          - `attributes` OncallRosterAttributes, required
            - `handoverTemplateId` string, required
            - `name` string, required
            - `schedules` OncallSchedule[], required
              - …
            - `slug` string, required
          - `id` string, required
        - `startAt` string, date-time, required
        - `user` User, required
          - `attributes` UserAttributes, required
            - `email` string, required
            - `name` string, required
            - `organizationRole` 'admin' | 'member', required
          - `id` string, required
      - `id` string, required
    - `watchingRosters` OncallRoster[], required
      - `attributes` OncallRosterAttributes, required
        - `handoverTemplateId` string, required
        - `name` string, required
        - `schedules` OncallSchedule[], required
          - `attributes` OncallScheduleAttributes, required
            - `description` string, required
            - `participants` OncallScheduleParticipant[], required
              - …
            - `roster` OncallRoster, required — recursive
            - `timezone` string, required
          - `id` string, required
        - `slug` string, required
      - `id` string, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Unprocessable Entity
- `500` — Internal Server Error

---

[API](https://skmtc.net/rezible/apis/rezible-api.md) · [All operations](https://skmtc.net/rezible/apis/rezible-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rezible/rezible-api/versions/d226beeef0bf/schema)