---
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

## Changes

- **2026-07-27** `f7c013875516` — 17 warning
  - added the new `account_locked` enum value to the `status` response property for the response status `200`
  - added the new `config_error` enum value to the `status` response property for the response status `200`
  - added the new `done` enum value to the `status` response property for the response status `200`
  - added the new `error` enum value to the `status` response property for the response status `200`
  - …13 more

[Change history](https://skmtc.dev/truv/apis/truv-api/changes/v1/refresh/tasks/:task_id/get.md)

---

[API](https://skmtc.dev/truv/apis/truv-api.md) · [All operations](https://skmtc.dev/truv/apis/truv-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/truv/truv-api/revisions/d7195c30b6b1/schema)