> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getkato.io/llms.txt
> Use this file to discover all available pages before exploring further.

# List tasks

> Retrieve a page of tasks visible to the access key's owner.

Requires `tasks:read`. Owners and admins can access workspace tasks. Regular
members see tasks they created or are assigned to. The key owner's current
membership and role are checked on each request.

<ParamField query="limit" type="integer" default={25}>
  Number of tasks per page, capped at 100.
</ParamField>

<ParamField query="cursor" type="string">
  Opaque `next_cursor` from the previous page. Keep other filters unchanged.
</ParamField>

<ParamField query="include_archived" type="boolean" default={false}>
  Include archived tasks when set to `true`.
</ParamField>

Tasks are ordered newest first by creation time, with ID as a tie-breaker.
This endpoint has no status or assignee filter.

<ResponseField name="data" type="object[]">
  Visible tasks. See [task response formats](/api-reference/tasks/overview#date-and-response-formats).
</ResponseField>

<ResponseField name="has_more" type="boolean">
  Whether another page is available.
</ResponseField>

<ResponseField name="next_cursor" type="string | null">
  Cursor for the next request, or `null` on the last page.
</ResponseField>

<RequestExample>
  ```bash Request theme={null}
  curl --fail-with-body --silent --show-error --get \
    https://api.getkato.io/v1/tasks \
    -H "Authorization: Bearer $KATO_API_KEY" \
    --data-urlencode "limit=25"
  ```
</RequestExample>

<ResponseExample>
  ```json Empty result theme={null}
  {
    "data": [],
    "has_more": false,
    "next_cursor": null
  }
  ```
</ResponseExample>


## Related topics

- [Tasks API](/api-reference/tasks/overview.md)
- [All endpoints](/api-reference/endpoints.md)
- [Raycast API](/api-reference/raycast/overview.md)
- [List my Raycast tasks](/api-reference/raycast/tasks-list.md)
- [List Raycast task statuses](/api-reference/raycast/task-statuses.md)