---
title: "Find schedule preferences"
method: GET
path: "/schedule/preferences/users/{userId}"
tags: ["schedule-preferences"]
---

# Find schedule preferences

`GET /schedule/preferences/users/{userId}`

## Request

- Base URL: `https://api.smartrecruiters.com/interview-templates`
- URL: `https://api.smartrecruiters.com/interview-templates/schedule/preferences/users/{userId}`
- Auth: one of:
  - API key in header `x-smarttoken`
  - OAuth 2
    - Authorization code: `https://www.smartrecruiters.com/identity/oauth/allow`
    - Client credentials
    - Token URL: `https://api.smartrecruiters.com/identity/oauth/token` scopes: `schedule_preferences_read`

Finds schedule preferences for provided user.

## Path parameters

- `userId` string, ^[a-fA-F0-9]{24}$, required

## Response `200`

Successfully found schedule preferences.

- SchedulePreferencesExternal
  - `availabilityHours` object: Days of the week (Mo - Su) along with availability slots which define the hours when the user is available for interviews
  - `availabilitySpecificSlots` AvailabilitySpecificSlotExternalDto[]: Start and end timestamps which define the specific availability slots for interviews
    - `start` string, date-time: Start timestamp of the availability specific slot in the ISO 8601 date time format (YYYY-MM-DDTHH:MM:SS)
    - `end` string, date-time: End timestamp of the availability specific slot in the ISO 8601 date time format (YYYY-MM-DDTHH:MM:SS)
  - `bufferTimeInMinutes` integer: The amount of time in minutes that the user needs between any two consecutive interviews
  - `advanceTimeInMinutes` integer: The flag indicating the minimum amount of time in minutes that the user needs to prepare for an interview
  - `dailyInterviewLimit` integer: The maximum number of interviews that the user can conduct in a day

## Other responses

- `401`: Unauthorized.

---

[API](https://skmtc.dev/smartrecruiters/apis/interview-templates-api.md) - [All operations](https://skmtc.dev/smartrecruiters/apis/interview-templates-api/llms.txt) - [OpenAPI document](https://skmtc.dev/smartrecruiters/apis/interview-templates-api/revisions/080537e890a2?raw)