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>
ID 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": []
}Metadata included in every API response.
Unique identifier for the request, for tracking and debugging.
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
{
"meta": {
"request_id": "BXaEFVtjc7TXaJxgZhmFgSUD9edqq_CN"
},
"error": {
"code": "UNAUTHORIZED",
"message": "Authentication is required."
}
}Standard envelope returned by all error (4xx/5xx) responses.
Metadata included in every API response.
Unique identifier for the request, for tracking and debugging.
Machine- and human-readable detail for a failed request.
Stable, screaming-snake-case identifier for the error condition. Clients should branch on this, not on message. Common values include BAD_REQUEST, UNAUTHORIZED, FORBIDDEN, NOT_FOUND, CONFLICT_ERROR, PERMISSION_ERROR, UNPROCESSABLE_ENTITY, UNPROCESSABLE_CONTENT, TOO_MANY_REQUESTS, INTERNAL_SERVER_ERROR, DUPLICATION_FAILED, SERVICE_UNAVAILABLE; domains may define additional codes.
Short, human-readable summary of the error.
Optional longer explanation specific to this occurrence.
Access forbidden
{
"meta": {
"request_id": "BXaEFVtjc7TXaJxgZhmFgSUD9edqq_CN"
},
"error": {
"code": "FORBIDDEN",
"message": "You do not have access to this resource."
}
}Standard envelope returned by all error (4xx/5xx) responses.
Metadata included in every API response.
Unique identifier for the request, for tracking and debugging.
Machine- and human-readable detail for a failed request.
Stable, screaming-snake-case identifier for the error condition. Clients should branch on this, not on message. Common values include BAD_REQUEST, UNAUTHORIZED, FORBIDDEN, NOT_FOUND, CONFLICT_ERROR, PERMISSION_ERROR, UNPROCESSABLE_ENTITY, UNPROCESSABLE_CONTENT, TOO_MANY_REQUESTS, INTERNAL_SERVER_ERROR, DUPLICATION_FAILED, SERVICE_UNAVAILABLE; domains may define additional codes.
Short, human-readable summary of the error.
Optional longer explanation specific to this occurrence.
Too Many Requests
{
"meta": {
"request_id": "BXaEFVtjc7TXaJxgZhmFgSUD9edqq_CN"
},
"error": {
"code": "TOO_MANY_REQUESTS",
"message": "Rate limit exceeded. Retry later."
}
}Standard envelope returned by all error (4xx/5xx) responses.
Metadata included in every API response.
Unique identifier for the request, for tracking and debugging.
Machine- and human-readable detail for a failed request.
Stable, screaming-snake-case identifier for the error condition. Clients should branch on this, not on message. Common values include BAD_REQUEST, UNAUTHORIZED, FORBIDDEN, NOT_FOUND, CONFLICT_ERROR, PERMISSION_ERROR, UNPROCESSABLE_ENTITY, UNPROCESSABLE_CONTENT, TOO_MANY_REQUESTS, INTERNAL_SERVER_ERROR, DUPLICATION_FAILED, SERVICE_UNAVAILABLE; domains may define additional codes.
Short, human-readable summary of the error.
Optional longer explanation specific to this occurrence.
Internal server error
{
"meta": {
"request_id": "BXaEFVtjc7TXaJxgZhmFgSUD9edqq_CN"
},
"error": {
"code": "INTERNAL_SERVER_ERROR",
"message": "An unexpected error occurred."
}
}Standard envelope returned by all error (4xx/5xx) responses.
Metadata included in every API response.
Unique identifier for the request, for tracking and debugging.
Machine- and human-readable detail for a failed request.
Stable, screaming-snake-case identifier for the error condition. Clients should branch on this, not on message. Common values include BAD_REQUEST, UNAUTHORIZED, FORBIDDEN, NOT_FOUND, CONFLICT_ERROR, PERMISSION_ERROR, UNPROCESSABLE_ENTITY, UNPROCESSABLE_CONTENT, TOO_MANY_REQUESTS, INTERNAL_SERVER_ERROR, DUPLICATION_FAILED, SERVICE_UNAVAILABLE; domains may define additional codes.
Short, human-readable summary of the error.
Optional longer explanation specific to this occurrence.