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

# List all tasks

`GET /v1/tasks/`

The endpoint returns a list of Tasks.

## Query parameters

- `ordering` 'created_at' | '-created_at' | 'updated_at' | '-updated_at' | 'status' | '-status' | 'error_message' | '-error_message' | 'provider_id' | '-provider_id'
- `created_at__lte` string, date-time
- `created_at__gte` string, date-time
- `status` 'done' | 'error' | 'login_error' | 'account_locked' | 'mfa_error' | 'config_error' | 'no_data' | 'unavailable' | 'unable_to_reset' | 'not_supported'
- `query` string
- `provider` string
- `product_type` 'income' | 'employment' | 'deposit_switch' | 'pll' | 'insurance' | 'transactions' | 'assets'
- `user_id` string
- `cursor` string
- `page_size` integer

## Response `200`

- object
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` Task[], required
    - `id` string, required — Unique task identifier
    - `status` 'done' | 'error' | 'login_error' | 'account_locked' | 'mfa_error' | 'config_error' | 'no_data' | 'unavailable' | 'unable_to_reset' | 'not_supported', required — Current task status
    - `product_type` 'income' | 'employment' | 'deposit_switch' | 'pll' | 'insurance' | 'transactions' | 'assets', required — Type of data product being processed
    - `provider` object, required
      - `id` string, required — Data provider ID.
      - `name` string, required — Data provider name.
      - `logo_url` string, uri — Data provider logo image.
    - `created_at` string, date-time, required — Task creation timestamp (ISO 8601)
    - `updated_at` string, date-time, required — Task last update timestamp (ISO 8601)
    - `error_message` string, nullable — Error details if task failed
    - `tracking_info` string, nullable — Optional tracking information provided by partner
    - `bridge_token` string, nullable — Bridge token used for authentication
    - `data_source` 'payroll' | 'docs' | 'insurance' | 'financial_accounts' | 'tax' — Source of the data collection
    - `link_id` string, required — ID of the associated link (connection)
    - `is_suspicious` boolean — Whether the task or link is flagged as suspicious
    - `user_id` string, required — ID of the user associated with this task
    - `order_id` string, nullable — ID of the order associated with this task

## Other responses

- `401` — HTTP 401 Unauthorized
- `403` — HTTP 403 Forbidden

---

[API](https://skmtc.net/truv/apis/truv-api.md) · [All operations](https://skmtc.net/truv/apis/truv-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/truv/truv-api/versions/6542a8962887/schema)