data_table_id or integration_id with error=True. One scheduled 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, error_type and error_description.
error_category tells you why the connection 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
Keep only imports that touched this resource type: ‘data_table’, ‘quota’ or
‘user’. Omit for every type.
string
Keep only imports in this state: ‘scheduled’, ‘started’ or ‘finished’. Omit
for every state.
string
Keep only imports created at or after this instant. Accepts an absolute
ISO-8601 date/time (‘2026-07-01’) or a duration relative to now (‘-P7D’ for
the last 7 days). Omit for no lower bound.
string
Keep only imports created at or before this instant. Same accepted forms as
created_after. Omit for no upper bound.
string
Keep only imports with a batch for the data table with this id — the id
list_data_tables returns. Omit for every table.
string
Keep only imports with a batch synced from the integration with this id —
the id list_integrations returns. Omit for every integration.
boolean
True keeps only imports with at least one failed batch; False keeps only
imports where every batch succeeded. 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 keeps only imports with a batch that rejected or skipped rows, even if
it did not fail; False keeps only imports with none. Counted like error.
Omit for both.
integer
Page size, between 1 and 250. Defaults to 50.
integer
Row offset into the result set — the number of rows to skip before this
page. Any offset >= 0 is accepted; it does not have to be a multiple of
limit, so you can start from an arbitrary row. Pass the next_offset returned
by the previous call to walk the pages, or None for the first page.