Validate a CSV file
Check a CSV file's contents before uploading it. Always answers 200; check isValid and errors to see whether the file passed.
Authorization
Headers
Release date, as YYYY-MM-DD. Defaults to 2026-07-21.
Target organization id (Organization-Id selector).
Target connection id; resolves to its organization.
Platform entity id; resolves to a connection's organization.
Optional source to disambiguate an Entity-Id.
Body
Name of the file being validated.
Raw CSV file contents.
Import source the file was exported for.
SALE or PURCHASE for the whole file; blank per-row direction cells take this value.
SALEPURCHASEResponse
True when every row passed validation.
Name of the file that was validated.
Number of data rows found in the file.
Human-readable validation error messages. Empty when isValid is true.
Rows that passed validation, parsed and normalized. Empty when the file was rejected outright or every row failed.
Rows that failed validation, with their raw values and per-field errors.
A file-level rejection reason (unsupported source, bad format, duplicate headers). Null unless the whole file was rejected.
Successful Response
The request was invalid.
Authentication failed or was missing.
The credential is not permitted for this request.
The requested resource was not found.
The request failed validation.