---
title: "Query Staffs"
method: GET
path: "/staffs"
tags: ["Task"]
---

# Query Staffs

`GET /staffs`

You can query schedule staffs (cleaners / operators / receptionists, etc.) by making a request to this endpoint.

## Query parameters

- `offset` integer
- `limit` integer
- `id` integer
- `is_active` 0 | 1

## Response `200`

A list of staffs with their details

- object
  - `request_id` string, required — Unique identifier for the request.
  - `error_code` integer, required — Numeric error code representing the status of the response. A value of `200` indicates success. <br> See the [Error Codes](/reference/error-manual#error-codes) section for more information.
  - `error_msg` string, required — Message detailing the status of the response.
  - `data` object, required
    - `staffs` object[], required — List of the staffs
      - `id` integer, required — Unique identifier for the staff
      - `name` string, required — Name of the staff
      - `mobile` string — Mobile number of the staff
      - `email` string — Email address of the staff
      - `note` string — Note attached to the staff
      - `is_active` boolean, required — Whether the staff is active.
    - `total` integer, required — Total number of staffs.

---

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