Retrieve a paginated, filterable list of transfer runs for a specific transfer. Supports date range filtering, issue filtering, sorting, and pagination.
Returns: Array of transfer run objects.
Important Notes:
- Requires scope
dwh_transfers_read - Your account must have
dwh.transfer.viewpermission. See roles and permissions. - The transfer must exist and belong to your team
- Start date and end date are required parameters
- Results are paginated (default limit: 100, max: 10000)
Bearer token authentication. Include the token in the Authorization header:
Authorization: Bearer <your-token>
Unique identifier of the team
Unique identifier of the transfer
Start date for filtering runs (inclusive)
End date for filtering runs (inclusive)
Filter to show only runs with issues
Field to sort by
Sort direction
Maximum number of results to return (default 100, max 10000)
Number of results to skip for pagination
Transfer runs retrieved successfully
Multiple transfer runs
{
"meta": {
"request_id": "01892A4D-7586-7000-8000-000000000000"
},
"data": [
{
"id": 12345,
"status": "COMPLETED",
"created_time": "2024-01-15T09:55:00Z",
"ended_time": "2024-01-15T10:05:30Z",
"type": "Recurring",
"total_duration": 330.5,
"total_rows": 4500,
"data_date": "2024-01-15",
"message": ""
},
{
"id": 12344,
"status": "FAILED",
"created_time": "2024-01-14T09:55:00Z",
"ended_time": "2024-01-14T10:02:00Z",
"type": "Recurring",
"total_duration": 420,
"total_rows": 0,
"data_date": "2024-01-14",
"message": "Connection timeout to data source"
},
{
"id": 12343,
"status": "COMPLETED",
"created_time": "2024-01-13T14:00:00Z",
"ended_time": "2024-01-13T14:08:15Z",
"type": "Backfill",
"total_duration": 495,
"total_rows": 8200,
"data_date": "2024-01-13",
"message": ""
}
]
}No transfer runs found
{
"meta": {
"request_id": "01892A4D-7586-7000-8000-000000000000"
},
"data": []
}API request ID
Array of transfer run objects
Unique identifier of the transfer run
Current status of the transfer run
Timestamp when the transfer run was created (ISO 8601 format)
Timestamp when the transfer run finished processing (ISO 8601 format)
Type of the transfer run
Sum of all query durations in seconds
Total number of rows processed during the transfer run
The data date this transfer run covers
Status message or error description for the transfer run
Unauthorized - Authentication is required and has failed or has not been provided.
{
"meta": {
"request_id": "019461A0-0000-7000-8000-000000000000"
},
"error": {
"code": "API_KEY_INVALID",
"message": "Invalid API key",
"description": "Provided API key was invalid."
}
}API request ID
Error code
Error message
Error description
Forbidden - The request is understood, but access is not allowed
{
"meta": {
"request_id": "01892A4D-7586-7000-8000-000000000000"
},
"error": {
"code": "ACCESS_DENIED",
"message": "Access Denied",
"description": "You do not have permission to perform this operation."
}
}API request ID
Error code
Error message
Error description
Too Many Requests - Rate limit exceeded.
{
"meta": {
"request_id": "019461A0-0000-7000-8000-000000000000"
},
"error": {
"code": "API_ROW_QUOTA_EXCEEDED",
"message": "Row quota exceeded",
"description": "You have exceeded your row-quota limit of rows for this month. Please log into Supermetrics Hub at https://hub.supermetrics.com/ and upgrade your plan, or contact our Supermetrics support team."
}
}API request ID
Error code
Error message
Error description
Internal Server Error - An error occurred on the server.
{
"meta": {
"request_id": "01892A4D-7586-7000-8000-000000000000"
},
"error": {
"code": "INTERNAL_SERVER_ERROR",
"message": "Internal Server Error",
"description": "An unexpected error occurred. Please try again later or contact support."
}
}API request ID
Error code
Error message
Error description