> ## 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 my Raycast tasks

> List non-archived tasks assigned to the authorized member.

List non-archived tasks assigned to the authorized member.

Use an OAuth access token issued to `kato-raycast`. Developer keys cannot call this endpoint. See [Raycast authentication](/api-reference/raycast/overview).

Required scopes: `tasks:read`.

This list is assigned-to-me even for an administrator. It is ordered by due date ascending (undated last), then update time descending and ID ascending. It uses offset cursors and camelCase pagination.

## Parameters

<ParamField query="completion" type="string">
  open (default), completed, or all. Completion follows workspace status definitions.
</ParamField>

<ParamField query="cursor" type="string">
  Opaque nextCursor returned by this Raycast collection; do not use a developer API cursor.
</ParamField>

<ParamField query="limit" type="integer">
  Default 50; 1–100.
</ParamField>

## Response

**200** — Task summary array under `data`, plus `hasMore` and `nextCursor`. See [Raycast task fields](/api-reference/raycast/models#tasks).

<ResponseExample>
  ```json 200 theme={null}
  {
    "data": [
      {
        "id": "task_example",
        "title": "Prepare kickoff",
        "description": null,
        "status": "todo",
        "priority": "no_priority",
        "assignees": [],
        "dueDate": null,
        "timeLogged": 0,
        "estimatedTime": null,
        "createdBy": "user_example",
        "createdAt": "2026-09-07T12:00:00.000Z",
        "updatedAt": "2026-09-07T12:00:00.000Z",
        "linkedMeetingIds": [],
        "fileCount": 0,
        "linkedRecordCount": 0,
        "timerState": null,
        "webUrl": "https://app.getkato.io/northlane/tasks/task_example/details"
      }
    ],
    "hasMore": false,
    "nextCursor": null
  }
  ```
</ResponseExample>

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


## Related topics

- [All endpoints](/api-reference/endpoints.md)
- [List Raycast task statuses](/api-reference/raycast/task-statuses.md)
- [Raycast](/integrations/raycast.md)
- [Navigating Kato](/documentation/navigating-kato.md)
- [Raycast API](/api-reference/raycast/overview.md)