---
title: "Retrieve a data refresh status"
method: GET
path: "/v1/refresh/tasks/{task_id}/"
tags: ["Data Refresh"]
---

# Retrieve a data refresh status

`GET /v1/refresh/tasks/{task_id}/`

The endpoint returns the refresh task status.

## Response `200`

- RefreshTask — Link data refresh task
  - `id` string, required — Unique refresh task ID
  - `created_at` string — Time when refresh task was created
  - `refresh_date` string, date, required — Date of the data refresh **(Deprecated, invalid datetime format)**
  - `status` 'new' | 'login' | 'mfa' | 'parse' | 'full_parse' | 'switch_deposit' | 'session_expired' | 'done' | 'error' | 'login_error' | 'account_locked' | 'mfa_error' | 'config_error' | 'no_data' | 'unavailable' | 'unable_to_reset' | 'not_supported', required — [Refresh task status](#task-statuses). Includes in-progress statuses (`new`, `login`, `mfa`, `parse`, `full_parse`, `switch_deposit`, `session_expired`) that appear while the refresh is still running, and the terminal statuses shared with [tasks](/api-reference/tasks/lifecycle).

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