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

# List tasks

`GET /tasks`

## Request

- Base URL: `https://api.rhythms.ai`
- URL: `https://api.rhythms.ai/tasks`
- Auth: none required

Returns the tasks the caller can see, newest first, optionally narrowed to one object, owner or set of statuses.

This endpoint supports filtering and pagination through query parameters. Available ransackable attributes: uuid, title, status, owner_uuid, creator_uuid, subject_type, subject_uuid, due_on, created_at, updated_at.

## Query parameters

- `page` number
- `per_page` number
- `limit` number
- `limit_max` number
- `offset` number
- `count` string
- `subject_type` 'Okrs::Goal'
- `subject_uuid` string
- `owner_uuid` string
- `status` string[]
- `closed_since` string
- `q` object

## Other responses

- `400`: Bad Request - Invalid parameters or malformed request
- `401`: Unauthorized - Invalid or missing authentication
- `403`: Forbidden - User lacks permission to access this resource
- `404`: Not Found - Resource does not exist
- `422`: Unprocessable Entity - Invalid request parameters or validation errors
- `429`: Too Many Requests - Rate limit exceeded
- `500`: Internal Server Error - Unexpected server error

## Changes

- **2026-10-29** `3776068254ff`: 1 info
  - added the new optional `query` request parameter `closed_since`
- **2026-10-15** `7ed8cef9d8e9`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/rhythms/apis/rhythms-params-in-body/changes/tasks/get.md)

---

[API](https://skmtc.dev/rhythms/apis/rhythms-params-in-body.md) - [All operations](https://skmtc.dev/rhythms/apis/rhythms-params-in-body/llms.txt) - [OpenAPI document](https://skmtc.dev/rhythms/apis/rhythms-params-in-body/revisions/3776068254ff?raw)