Skip to main content
GET
List tasks

Authorizations

Authorization
string
header
required

API key created in Workspace Settings → API Keys. Pass it in the Authorization header as a Bearer token, or in the X-API-Key header.

Format: el_ followed by 40 hex characters.

Path Parameters

projectSlug
string
required

The slug of the project (visible in the project URL).

Example:

"my-project"

Query Parameters

page
integer
default:1

Page number (1-based).

Required range: x >= 1
limit
integer
default:20

Number of tasks per page. Maximum is 100.

Required range: 1 <= x <= 100
statusId
string<uuid>

Filter by a specific custom status UUID. Takes precedence over status if both are provided. Use GET /{projectSlug}/statuses to retrieve available status IDs.

Example:

"018e1b2c-aaaa-0000-0000-000000000002"

status
enum<string>

Filter by status category. Ignored when statusId is provided.

Available options:
todo,
in_progress,
done
priority
enum<string>

Filter by task priority.

Available options:
none,
low,
medium,
high,
urgent

Full-text search in task title or external ID (e.g. PROJ-42).

assigneeId
string<uuid>

Filter by assignee user UUID. Use GET /{projectSlug}/members to retrieve available IDs.

Example:

"018e1b2c-0000-0000-0000-000000000099"

labelId
string<uuid>

Filter by label UUID. Use GET /{projectSlug}/labels to retrieve available IDs.

Example:

"018e1b2c-aaaa-0000-0000-000000000010"

Response

A paginated list of tasks.

tasks
object[]
meta
object