Introduction
Organization APIs
- Users
- Invitations
- Workspaces
Workspace APIs
- Syncs
- Sync Management Links
- Sync Runs
- Destination Types
- Destinations
- Destination Connect Links
- Source Types
- Sources
- Source Connect Links
- Segment Management Links
- Webhooks
List sync runs
curl --request GET \
--url https://app.getcensus.com/api/v1/syncs/{sync_id}/sync_runs \
--header 'Authorization: Bearer <token>'
{
"status": "success",
"pagination": {
"total_records": 14,
"per_page": 25,
"prev_page": 1,
"page": 2,
"next_page": 3,
"last_page": 10
},
"data": [
{
"id": 94,
"sync_id": 52,
"source_record_count": 15,
"source_record_updates": 12,
"source_record_deletes": 2,
"source_record_invalids": 1,
"records_processed": 14,
"records_updated": 13,
"records_failed": 1,
"created_at": "2021-10-20T02:51:07.546Z",
"updated_at": "2021-10-20T02:52:29.236Z",
"completed_at": "2021-10-20T02:52:29.234Z",
"scheduled_execution_time": "2021-10-20T02:52:29.234Z",
"error_code": "JSON_ARRAY_ERROR",
"error_message": "The array field being used does not appear to be valid JSON...",
"error_detail": "Please make sure the field \"custom_field:Users\" with value \"jim\" is formatted as a JSON Array...",
"status": "completed",
"canceled": false,
"full_sync": true,
"current_step": "Running Sync"
}
]
}
Authorizations
Bearer token for the current workspace. Can be retrieved from the Workspace's settings page.
Path Parameters
The ID of the sync for which to list runs.
Query Parameters
Designates which page of results to return. Always starts at 1. If 0 is specified, it defaults to 1.
Determines the number of results on each page. It can't exceed 100.
x <= 100
Organizes the results based on their creation time, either ascending or descending.
asc
, desc
Response
A successfully fetched list of results.
The outcome of the request
success
"success"
An object to help you navigate the list of results.
Total records in the collection.
14
Records on each page.
25
The previous page number, or null
for the first page.
1
The current page number.
2
The next page number, or null
if it's the last page.
3
The number of the last page with records.
10
The list of results.
ID of this sync run.
94
ID of the sync.
52
The number of records in the source object at the time of the sync run.
15
The number of new or updated records found in the source.
12
The number of records deleted in the source.
2
Number of source records skipped by Census because of data quality issues.
1
Number of records sent to the destination.
14
Number of records successfully sent to the destination.
13
Number of records rejected by the destination.
1
When this sync run was created.
"2021-10-20T02:51:07.546Z"
When this sync run was updated.
"2021-10-20T02:52:29.236Z"
When this sync run was completed.
"2021-10-20T02:52:29.234Z"
When the sync run was scheduled to run.
"2021-10-20T02:52:29.234Z"
The error code, if any.
"JSON_ARRAY_ERROR"
The error message, if any.
"The array field being used does not appear to be valid JSON..."
Details about the error, if any.
"Please make sure the field \"custom_field:Users\" with value \"jim\" is formatted as a JSON Array..."
Status of the sync run. Possible values are:
working
: The sync is currently executing.completed
: The sync finished successfully.failed
: The sync failed during execution.skipped
: An earlier instance of the sync is still running, so this run was skipped.queued
: The sync run is queued for execution.
working
, completed
, failed
, skipped
, queued
"completed"
Whether or not this sync run was canceled.
false
Whether or not this was a full sync.
A short human-readable description of the trigger for this sync run
"Manual"
A longer human-readable description of the trigger for this sync run. For example, including the email of the user that triggered it
"Manually triggered by test@getcensus.com"
The current step of the sync run. Available if the sync is running.
Checking for columns to remove from the sync
, Checking for fields to create in destination
, Checking source and destination configuration
, Unloading data from warehouse
, Loading data into destination service
, Committing data to destination service
, Committing sync to warehouse
, Running sync
"Running Sync"
Was this page helpful?
curl --request GET \
--url https://app.getcensus.com/api/v1/syncs/{sync_id}/sync_runs \
--header 'Authorization: Bearer <token>'
{
"status": "success",
"pagination": {
"total_records": 14,
"per_page": 25,
"prev_page": 1,
"page": 2,
"next_page": 3,
"last_page": 10
},
"data": [
{
"id": 94,
"sync_id": 52,
"source_record_count": 15,
"source_record_updates": 12,
"source_record_deletes": 2,
"source_record_invalids": 1,
"records_processed": 14,
"records_updated": 13,
"records_failed": 1,
"created_at": "2021-10-20T02:51:07.546Z",
"updated_at": "2021-10-20T02:52:29.236Z",
"completed_at": "2021-10-20T02:52:29.234Z",
"scheduled_execution_time": "2021-10-20T02:52:29.234Z",
"error_code": "JSON_ARRAY_ERROR",
"error_message": "The array field being used does not appear to be valid JSON...",
"error_detail": "Please make sure the field \"custom_field:Users\" with value \"jim\" is formatted as a JSON Array...",
"status": "completed",
"canceled": false,
"full_sync": true,
"current_step": "Running Sync"
}
]
}