error / warning flags. Combine
the filters (AND) to zoom in, e.g. resource_type='quota' + status='finished',
or error=true to triage failed runs. Fetch
get_import for the per-batch detail of
a single run. Only the last 12 months are queryable. Filtering by a
resource_type you may not read is refused with a permission error, and a run
that also synced resources you may not read is summarized on the batches you
may read.
To find out why one table or one connection fails to sync, pass its
data_table_id or integration_id with error=true. One refresh imports
every table of a connection, so the error is judged on the batches those ids
select, not on the whole run. Then call
get_import on a returned run and read
the failed batch’s error_category and error_description. error_category
tells you why the sync failed (for example authentication means you need to
reconnect it, rate_limit means you should retry later).
warning=true
to find those runs, then read the batch’s rejected_rows in
get_import. Each rejected row comes
with its reason and a locator, such as the CSV line it came from or the user it
is about. That is where you answer “why didn’t my users come in?”.
Parameters
Body
Body
string
Only imports that touched this resource type; refused if you may not read
it. Omit for every type. One of:
data_table, quota, user.string
Only imports in this state, judged on the batches you can read. Omit for
every state. One of:
scheduled, started, finished.string
Only imports created at or after this instant: an ISO-8601 date/time
(‘2026-07-01’) or a duration relative to now (‘-P7D’ for the last 7 days).
Never reaches back past 12 months.
string
Only imports created at or before this instant, in the forms
after takes.
Omit for no upper bound.string
Only imports with a batch for this data table (id from list_data_tables);
refused if you may not read data table imports.
string
Only imports with a batch synced from this integration (id from
list_integrations).
boolean
true: only imports with a failed batch; false: only imports with none. Only
the batches you can read count, and with data_table_id or integration_id
only the ones they select (a run where another table failed is not in error
for this one). Omit for both.
boolean
true: only imports with a batch that rejected or skipped rows, even if it
did not fail; false: only imports with none. Counted like
error. Omit for
both.integer
Rows per page, 1 to 250. Default 50.
integer
Rows to skip. Omit it for the first page, never null or the string ‘None’;
for the next page pass the previous next_offset.