---
title: "Query Tasks"
method: GET
path: "/tasks"
tags: ["Task"]
---

# Query Tasks

`GET /tasks`

You can query schedule tasks (cleaning / maintain / reception / housekeeping / others) by making a request to this endpoint.

## Query parameters

- `id` integer
- `offset` integer
- `limit` integer
- `start_date` string, date
- `end_date` string, date
- `staff_id` integer
- `property_id` integer
- `type` 'cleaning' | 'maintenance' | 'reception' | 'room_service' | 'other'
- `status` 'pending' | 'in_progress' | 'completed' | 'cancelled'

## Response `200`

A list of tasks 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
    - `tasks` object[], required — List of the tasks
      - `id` integer, required — Unique identifier for the task
      - `type` 'cleaning' | 'maintenance' | 'reception' | 'room_service' | 'other', required — Task type.
      - `status` 'pending' | 'in_progress' | 'completed' | 'cancelled', required — Task status.
      - `property_id` integer, nullable — Property id this task belongs to. Null if the task is not bound to a property.
      - `property_title` string, nullable — Title of the property this task belongs to.
      - `stay_code` string, nullable — Stay code this task is linked to. Null when the task is not linked to a reservation.
      - `staff_id` integer, nullable — Id of the staff this task is assigned to. Null if the task is not assigned.
      - `staff_name` string, nullable — Name of the staff this task is assigned to.
      - `expected_date` string, date — Expected execution date in YYYY-MM-DD.
      - `expected_time` string, nullable — Expected execution time in HH:mm:ss. May be null when only date is set.
      - `expected` string — Expected execution datetime in YYYY-MM-DD HH:mm:ss.
      - `level` 'standard' | 'simple' | 'advanced', nullable — Cleaning level.
      - `currency` string, nullable — The currency code for the fee.
      - `fee` number, float — Task fee.
      - `note` string — Note attached to the task.
      - `create_time` string, nullable — Time when the task was created (YYYY-MM-DD HH:mm:ss).
      - `update_time` string, nullable — Time when the task was last updated (YYYY-MM-DD HH:mm:ss).
    - `total` integer, required — Total number of tasks.

---

[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)