Skip to main content
GET
/
v1
/
refresh
/
tasks
/
{task_id}
Retrieve a Data Refresh Status
curl --request GET \
  --url https://api.example.com/v1/refresh/tasks/{task_id}

​
Description

This endpoint retrieves the current status of a data refresh task. It returns information about the refresh operation that was previously initiated.

​
Authentication

This endpoint requires API credentials:
  • Client ID (header)
  • Access Key (header)

​
Path Parameters

ParameterTypeRequiredDescription
task_idstringYesThe unique identifier of the refresh task

​
Response

​
Success Response (200 OK)

Returns the refresh task status with details about the operation’s current state. 
{
  "id": "24d7e80942ce4ad58a93f70ce4115f5c",
  "created_at": "2021-04-06T11:30:00Z",
  "refresh_date": "2020-03-10",
  "status": "new"
}

​
Error Responses

401 Unauthorized: Authentication failed or no valid token provided. 403 Forbidden: Authentication credentials not provided. 404 Not Found: Task ID does not exist.