---
title: "Get the status of the data refresh"
method: GET
path: "/v2/data/refresh"
---

# Get the status of the data refresh

`GET /v2/data/refresh`

Returns the state, timing, and any error of the current or most recent data refresh

## Response `200`

Status of the current or most recent data refresh

- RefreshStatusResponse
  - `state` 'idle' | 'running' | 'succeeded' | 'failed' — Lifecycle state of the current or most recent refresh
  - `trigger` 'startup' | 'scheduled' | 'manual' — What initiated the refresh
  - `startedAt` string, date-time — Timestamp of when the refresh started
  - `finishedAt` string, date-time — Timestamp of when the refresh completed (absent while running)
  - `duration` string — Wall-clock duration of the last completed refresh
  - `lastError` string — Error message from the most recent failed refresh, if any

## Other responses

- `default` — Unexpected error

---

[API](https://skmtc.net/moov-io/apis/watchman-api.md) · [All operations](https://skmtc.net/moov-io/apis/watchman-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/moov-io/watchman-api/revisions/42ffeeb1e25a/schema)