---
title: "List or filter tasks"
method: GET
path: "/task/"
tags: ["tasks"]
---

# List or filter tasks

`GET /task/`

The `view` parameter can be used to conveniently access the different task views. It accepts one of the following values:

* `inbox`: Shows incomplete tasks up to the end of the user's day only (taking the time zone into account).
* `future`: Shows incomplete tasks starting from the user's tomorrow only (taking the time zone into account).
* `archive`: Shows complete tasks only.

Note that a `view` value of `inbox` or `future` will override any `date__lt` or `date__gte` parameters included in the same request.

The `_order_by` field allows ordering by `date` or `date_created` (descending order by prepending a minus, e.g. `_order_by=-date`).

## Query parameters

- `_limit` integer
- `_skip` integer
- `assigned_to` string, nullable
- `format` string, nullable
- `id` string, nullable
- `id__in` string, nullable
- `is_complete` string, nullable
- `lead_id` string, nullable
- `_order_by` string, nullable
- `organization_id` string, nullable
- `_type` string, nullable
- `_type__in` string, nullable
- `view` string, nullable
- `date` string, nullable
- `date__lt` string, nullable
- `date__lte` string, nullable
- `date__gt` string, nullable
- `date__gte` string, nullable
- `due_date` string, nullable
- `due_date__lt` string, nullable
- `due_date__lte` string, nullable
- `due_date__gt` string, nullable
- `due_date__gte` string, nullable
- `date_created__lt` string, nullable
- `date_created__lte` string, nullable
- `date_created__gt` string, nullable
- `date_created__gte` string, nullable
- `date_updated__lt` string, nullable
- `date_updated__lte` string, nullable
- `date_updated__gt` string, nullable
- `date_updated__gte` string, nullable
- `_fields` string

## Response `200`

Successful response

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `404` — Not found

---

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