---
title: "Retrieve a task"
method: GET
path: "/v1/tasks/{id}/"
tags: ["Tasks"]
---

# Retrieve a task

`GET /v1/tasks/{id}/`

The endpoint returns a Task.

## Response `200`

- Task
  - `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
- `404` — HTTP 404 Not Found

---

[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/b92671dcb52d/schema)