---
title: "🔒 Получение списка отпусков/больничных и остатка оплачиваемых дней отпуска."
method: GET
path: "/team/timeoff/list"
tags: ["Team: Timeoff"]
---

# 🔒 Получение списка отпусков/больничных и остатка оплачиваемых дней отпуска.

`GET /team/timeoff/list`

## Request

- Base URL: `http://localhost`
- URL: `http://localhost/team/timeoff/list`
- Auth: one of:
  - API key in header `sid` and API key in header `rts` and API key in header `sig`
  - HTTP bearer

Получение списка отпусков/больничных и остатка оплачиваемых дней отпуска.

**Access:** `authorized` (10 ) · **Scope:** `read`

**Allows:** `user:timeoff` (все обязательны; проверка в команде по ресурсу из запроса)

### TypeScript (copy-paste)

**`GET /team/timeoff/list`**

<details open><summary><b>Params</b></summary>

```typescript
export interface TeamTimeoffListParams {
  userID?: string | null
  /** Day key (YYYYMMDD or internal day index) */
  daykey?: number | null
}
```

</details>

<details open><summary><b>Response</b></summary>

```typescript
export type TeamTimeoffListResponse = IServerResponse<Resp_team_timeoff_list>

export interface IServerResponse<T = any> {
  code: number
  data: T
  srvTS: number
  rkey: string
}
```

</details>

> Полный файл типов: [`/docs/types`](/docs/types) · raw: [`/docs/api-types.ts`](/docs/api-types.ts)

## Query parameters

- `userID` string, uuid, nullable
- `daykey` integer, nullable: Day key (YYYYMMDD or internal day index)

## Headers

- `devID` string, uuid, required
- `tz` string, required
- `app` string, required
- `appVer` string, required
- `rKey` string

## Response `200`

OK — `IServerResponse<Resp_team_timeoff_list>`

- object
  - `code` integer, required
  - `data` RespTeamTimeoffList, required: ResponseData for team/timeoff/list
    - `list` UserTimeOff[], required
      - `ID` string, uuid, required
      - `cID` string, uuid, required
      - `userID` string, uuid, required
      - `roleID` string, uuid, required
      - `type` string, required
      - `paid` boolean, nullable
      - `sickLeaveID` string, nullable
      - `statementFID` string, uuid, nullable
      - `statementOrgID` string, uuid, nullable
      - `statementSentTS` integer, nullable: Unix timestamp in milliseconds
      - `year` integer, required
      - `startDayKey` integer, required: Day key (YYYYMMDD or internal day index)
      - `endDayKey` integer, nullable: Day key (YYYYMMDD or internal day index)
      - `daysCount` integer, required
      - `startWorkDayKey` integer, nullable: Day key (YYYYMMDD or internal day index)
      - `userNote` string, nullable
      - `userAvailable` boolean, nullable
      - `status` string, required
      - `adminNote` string, nullable
      - `adminUID` string, uuid, nullable
      - `payment` 'created' | 'paid': `created` = "created", `paid` = "paid"
      - `statement` object, nullable
      - `updTS` integer, required: Unix timestamp in milliseconds
      - `updUID` string, required
    - `paidDaysLeft` number, required
  - `srvTS` integer, required: Server timestamp (ms)
  - `rkey` string, required: Request key

## Other responses

- `400`: BadRequest / Validation — неверные params/body/headers
- `401`: Unauthorized: Active user session required
- `403`: AccessNotAllowed: Privilege user:timeoff required
- `404`: NotFound: Target user with specified ID does not exist
- `406`: TimeResync — расхождение rts с сервером

---

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