---
title: "List Tasks"
method: GET
path: "/tasks"
---

# List Tasks

`GET /tasks`

Returns a list of tasks relevant for the authenticated legal entity. Tasks are sorted algorithmically by importance. To filter by status include a `status` parameter for each status you wish to be included in the response.

## Query parameters

- `definition_id` string, nullable
- `start_date` string, date, nullable
- `end_date` string, date, nullable
- `include_managed` boolean, nullable
- `status` AccountTaskStatus[], nullable
- `tags` AccountTaskTag[], nullable — Tags are filtering criteria for tasks. When multiple tags are passed, tasks associated with at least one of the tags are returned.

## Response `200`

Successful Response

- AccountTask[]
  - `id` string, required
  - `context` union, required
    - TaskContextEmployee
      - `scope` 'employee'
      - `employee_id` string, required
    - TaskContextLegalEntity
      - `scope` 'legal-entity'
      - `legal_entity_id` string, required
  - `definition` AccountTaskDefinition, required
    - `id` string, required
    - `title` string, required
    - `summary` string, nullable
    - `description` string, required
    - `type` 'requirement' | 'data-collection' | 'criteria-collection', required
    - `resources` object[], required
    - `location` LocationRef, required
      - `id` string, required
      - `code` string, required
      - `name` string, required
  - `resolutions` object, required
  - `default_resolution_name` string, required
  - `managed_provider` AccountManagedProvider
    - `id` string, required
    - `name` string, required
  - `status` 'todo' | 'dismissed' | 'in-progress' | 'done', required
  - `period_start_date` string, date, nullable
  - `period_end_date` string, date, nullable
  - `due_date` string, date, nullable
  - `unblocks` AccountTaskDefinition[], required
    - `id` string, required
    - `title` string, required
    - `summary` string, nullable
    - `description` string, required
    - `type` 'requirement' | 'data-collection' | 'criteria-collection', required
    - `resources` object[], required
    - `location` LocationRef, required
      - `id` string, required
      - `code` string, required
      - `name` string, required
  - `fee` union
    - FeeFixed
      - `type` 'fixed'
      - `amount` string, required
    - FeeRange
      - `type` 'range'
      - `min` string, required
      - `max` string, required
    - FeeVariable
      - `type` 'variable'
      - `reason` string, required
  - `eta` AccountTaskETA
    - `estimation` AccountTaskEstimation, required
      - `min` integer, required
      - `max` integer, required
      - `unit` 'hour' | 'day' | 'week' | 'month', required
    - `earliest_date` string, date-time, nullable
    - `latest_date` string, date-time, nullable
  - `priority` 'high' | 'medium' | 'low'
  - `criteria_met` AccountTaskCriteria[], required
    - `key` string, required
    - `reason` string, required
    - `data` union
      - object
      - unknown
  - `tags` string[], nullable

## Other responses

- `422` — Validation Error

---

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