Retrieve a file import
Retrieve a single file import by its unique ID.
Authorizations
Path Parameters
Query Parameters
Filter the embedded row errors by outcome
Page size for the embedded row errors
1 <= x <= 200Offset for the embedded row errors
Response
The file import, plus an offset-paginated page of its row errors. Successful rows are not listed here — they are real records.
A file import (CSV/NACHA upload or bulk API submission) and its ingestion lifecycle. Aggregate fields (record_count, total_credits, total_debits, net_amount, date_range_start, date_range_end, currency) are merged in only on the stream-scoped index GET /data_streams/{key}/file_imports, and are trustworthy once status is completed.
pending, processing, replicating, completed, failed, cancelled Origin of the import (e.g. csv, nacha, bulk_api)
Records skipped due to on_conflict: skip matching an existing external_id
processed_items / total_items as a percentage (0-100)
True until rows start landing; file totals are unknown while parsing
Number of decimal places (2 for USD)
Currently processing with no heartbeat for >5 minutes
e.g. /v1/file_imports/123
e.g. /v1/file_imports/123/records
Aggregate; stream-scoped index only
Aggregate, in cents; stream-scoped index only
Aggregate, in cents; stream-scoped index only
Aggregate: credits minus debits, in cents; stream-scoped index only
Aggregate; stream-scoped index only
Aggregate; stream-scoped index only
Aggregate; stream-scoped index only