List sync runs

Authorizations

Authorization

string

headerrequired

Bearer token for the current workspace. Can be retrieved from the Workspace's settings page.

Path Parameters

sync_id

integer

required

The ID of the sync for which to list runs.

Query Parameters

page

number

default: 1

Designates which page of results to return. Always starts at 1. If 0 is specified, it defaults to 1.

per_page

number

default: 25

Determines the number of results on each page. It can't exceed 100.

Required range: x < 100

order

enum<string>

default: desc

Organizes the results based on their creation time, either ascending or descending.

Available options:

asc,

desc

Response

200 - application/json

A successfully fetched list of results.

status

enum<string>

required

The outcome of the request

Available options:

success

pagination

object

required

An object to help you navigate the list of results.

data

object[]

required

The list of results.

data.id

integer

ID of this sync run.

data.sync_id

integer

ID of the sync.

data.source_record_count

integer | null

The number of records in the source object at the time of the sync run.

data.source_record_updates

integer | null

The number of new or updated records found in the source.

data.source_record_deletes

integer | null

The number of records deleted in the source.

data.source_record_invalids

integer | null

Number of source records skipped by Census because of data quality issues.

data.records_processed

integer | null

Number of records sent to the destination.

data.records_updated

integer | null

Number of records successfully sent to the destination.

data.records_failed

integer | null

Number of records rejected by the destination.

data.created_at

string

When this sync run was created.

data.updated_at

string

When this sync run was updated.

data.completed_at

string | null

When this sync run was completed.

data.scheduled_execution_time

string | null

When the sync run was scheduled to run.

data.error_code

string | null

The error code, if any.

data.error_message

string | null

The error message, if any.

data.error_detail

string | null

Details about the error, if any.

data.status

enum<string>

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.

Available options:

working,

completed,

failed,

skipped,

queued

data.canceled

boolean

Whether or not this sync run was canceled.

data.full_sync

object

Whether or not this was a full sync.

data.current_step

enum<string>

The current step of the sync run. Available if the sync is running.

Available options:

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

Introduction

Organization APIs

Workspace APIs

Authorizations

Path Parameters

Query Parameters

Response