---
title: "Get a user's weekly planning"
method: GET
path: "/users/{userId}/plannings"
tags: ["users"]
---

# Get a user's weekly planning

`GET /users/{userId}/plannings`

Retrieves a user's weekly availability planning — the time slots during which the user is reachable via Ringover. The response contains a planning for each day of the week with start/end time ranges. If planning is not enabled in the user's settings, the `is_planning` field will be `false` and the time ranges will be empty.

**Permission:** `Users Read` required.

**Monitoring impact:**
- **OFF:** Returns planning only if `userId` matches **your own** user ID. Requesting another user's planning returns `404`.
- **ON:** Returns **any user's** planning in the team.

## Path parameters

- `userId` integer, required

## Response `200`

Successful operation

- UserPlannings
  - `team_id` integer — The user's team id
  - `user_id` integer — The user's id
  - `tz_identifier` string — The user's timezone
  - `tz_now` string — Current timestamp of the user's timezone
  - `planning_enable` boolean — True if the user have the planning option activated on myringover
  - `is_planning` boolean — True if the user is currently in his planning schedule
  - `is_snoozed` boolean — True if the user is currently in snooze
  - `time_ranges` TimeRanges[] — Array of all the user's schedules. time_ranges is null if planning_enable is equal to false
    - `day` integer — Day of the week (0 => Monday, 6 => Sunday)
    - `start` integer — Start time in minutes (0 => 0:00)
    - `end` integer — End time in minutes (1440 => 24:00)

## Other responses

- `400` — The provided user ID is invalid
- `401` — Authentication token is missing, invalid, expired, or Users Read permission is missing
- `404` — No user found with the specified ID (or you do not have access to this user without monitoring)
- `500` — Internal server error

---

[API](https://skmtc.net/ringover/apis/ringover-public-api.md) · [All operations](https://skmtc.net/ringover/apis/ringover-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ringover/ringover-public-api/revisions/9da73dd2f99e/schema)