Get a CSV import's status
Poll an import’s progress. imported_rows climbs against total_rows while the load runs; status reaches succeeded or failed and stays there.
failed_rows is the exact count of rows that could not be written, while row_errors carries only a capped sample of them for display.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Response
Successful Response
A CSV import's current state.
Poll this until status is terminal. imported_rows climbs as the load
runs, so it doubles as a progress bar against total_rows.
The mapping in force.
Why the whole job failed, if it did.
Rows that could not be written — the exact count.
Rows written so far.
A capped sample of per-row failures; failed_rows carries the full count.
Where a CSV import has got to.
PENDING is a parsed-and-stored upload the user has not committed yet —
it holds an inferred mapping and nothing else. RUNNING means the table
and its columns exist and the row job is inserting. The two terminal states
are absorbing: a job never leaves them.
pending, running, succeeded, failed The table this created; null before commit.
Rows this import will write: the file's rows, capped by the plan and by whatever max_rows the commit asked for.