---
title: "List employees"
method: GET
path: "/employees"
tags: ["Employees"]
---

# List employees

`GET /employees`

Handle HTTP requests regarding Customers.

## Query parameters

- `status` integer
- `email` string
- `started_work_from` string
- `started_work_to` string
- `finished_work_from` string
- `finished_work_to` string
- `page` integer
- `per_page` integer

## Headers

- `token` string, required

## Response `200`

ОК

- EmployeeListResponse — Department data
  - `result` object
    - `current_page` integer
    - `data` object[]
      - `id` string
      - `name` string
      - `email` string
      - `position` string
      - `grade` string
      - `residence` string, nullable
      - `residence_comment` string, nullable
      - `city` string, nullable
      - `country` string, nullable
      - `phone` string, nullable
      - `skype` string, nullable
      - `linked_in` string, nullable
      - `birth_date` string, nullable
      - `end_test` string, nullable
      - `fired_date` string, nullable
      - `start_date` string, nullable
      - `gender` string, nullable
      - `telegram` string, nullable
      - `additional_email` string, nullable
      - `additional_phone` string, nullable
      - `relocate` boolean, nullable
      - `duties` string, nullable
      - `description` string, nullable
      - `additional_info` string, nullable
      - `team` object[]
        - `id` string
        - `name` string
      - `career` object[]
        - `team` string, nullable
        - `start_date` string
        - `end_date` string, nullable
        - `test_period_start_date` string, nullable
        - `test_period_end_date` string, nullable
        - `company_name` string, nullable
        - `department` string, nullable
        - `position` string, nullable
        - `grade` string, nullable
        - `place` string, nullable
        - `comment` string, nullable
      - `contacts` object[]
        - `type_id` integer, nullable
        - `type_name` string
        - `value` string, nullable
      - `languages` object[]
        - `name` string, nullable
        - `level` string, nullable
      - `educations` object[]
        - `place` string, nullable
        - `period_start` string, nullable
        - `period_end` string, nullable
        - `specialization` string, nullable
        - `description` string, nullable
      - `skills` object[]
        - `name` string
      - `awards` object[]
        - `name` string
      - `avatar` string
      - `parent_team_ids` integer[]
    - `first_page_url` string
    - `from` integer
    - `last_page` integer
    - `last_page_url` string
    - `next_page_url` string, nullable
    - `path` string, nullable
    - `per_page` integer
    - `prev_page_url` string, nullable
    - `to` integer
    - `total` integer
  - `error` boolean
  - `code` integer
  - `messages` string[]

## Other responses

- `403` — Forbidden
- `422` — Invalid request parameters

---

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