Retrieve information about the most recent backfill for a specific transfer. This endpoint returns the latest backfill regardless of its status (pending, running, completed, failed, or cancelled).
Returns: The latest backfill object with its ID, status, progress information, and error details if any.
Important Notes:
- The transfer must exist and belong to your team
- Requires scope
dwh_transfers_read - Your account must have
dwh.transfer.viewpermission. See roles and permissions. - Returns 404 if no backfill has ever been created for this transfer
- The backfill object includes real-time progress tracking for running backfills
Bearer token authentication. Include the token in the Authorization header:
Authorization: Bearer <your-token>
Unique identifier of the team
Unique identifier of the transfer
Latest backfill retrieved successfully
Backfill currently in progress
{
"meta": {
"request_id": "01892A4D-7586-7000-8000-000000000000"
},
"data": {
"transfer_backfill_id": 12345,
"transfer_id": 456789,
"range_start_date": "2024-01-01",
"range_end_date": "2024-01-31",
"created_time": "2024-02-01T09:00:00Z",
"created_user_id": 789,
"start_time": "2024-02-01T10:00:00Z",
"end_time": null,
"status": "RUNNING",
"transfer_runs_total": 31,
"transfer_runs_created": 31,
"transfer_runs_completed": 15,
"transfer_runs_failed": 0,
"error_report": []
}
}Completed backfill
{
"meta": {
"request_id": "01892A4D-7586-7000-8000-000000000000"
},
"data": {
"transfer_backfill_id": 12344,
"transfer_id": 456789,
"range_start_date": "2023-12-01",
"range_end_date": "2023-12-31",
"created_time": "2024-01-15T07:00:00Z",
"created_user_id": 789,
"start_time": "2024-01-15T08:00:00Z",
"end_time": "2024-01-15T10:30:00Z",
"status": "COMPLETED",
"transfer_runs_total": 31,
"transfer_runs_created": 31,
"transfer_runs_completed": 31,
"transfer_runs_failed": 0,
"error_report": []
}
}API request ID
Unique identifier of the backfill
ID of the transfer this backfill belongs to
Start date of the backfill range
End date of the backfill range
Timestamp when the backfill was created (ISO 8601 format)
ID of the user who created the backfill
Timestamp when the backfill was cancelled/removed (ISO 8601 format)
ID of the user who cancelled/removed the backfill
Timestamp when the backfill processing started (ISO 8601 format)
Timestamp when the backfill processing completed (ISO 8601 format)
Current status of the backfill
Total number of transfer runs created for this backfill
Number of transfer runs that have been created
Number of transfer runs that have completed successfully
Number of transfer runs that have failed
List of errors that occurred during backfill processing (empty array if no errors)
The date of the transfer run that failed
Error message describing what went wrong
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
Transfer or backfill not found
{
"meta": {
"request_id": "01892A4D-7586-7000-8000-000000000000"
},
"error": {
"code": "NOT_FOUND",
"message": "Not Found",
"description": "No backfill has been created for this transfer yet, or the transfer does not exist or belong to your team."
}
}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