Export a transaction report
Kick off an asynchronous transaction report for the resolved organization and return 202 with the export's id. SUMMARY is aggregated figures; DETAILS is one row per transaction; COLLECTED is imported-tax sales in a jurisdiction. deliveryMethod chooses how you get it: EMAIL emails it to email when ready (a bearer session may omit email and use the signed-in user); DOWNLOAD stores it and you poll GET /transactions/exports/{exportId} for a presigned link (so email must be omitted). An EMAIL export for an organization that has disabled email delivery answers 400.
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
How to deliver the report. EMAIL emails it to email when ready; DOWNLOAD stores it and you poll GET /transactions/exports/{exportId} for a presigned link.
EMAILDOWNLOADWhich report to generate. SUMMARY is aggregated figures; DETAILS is one row per transaction; COLLECTED is imported-tax sales in a jurisdiction (the collected-tax drawer).
SUMMARYDETAILSCOLLECTEDEmail address the report is delivered to. Required when deliveryMethod is EMAIL unless the caller is a bearer session (which defaults to the signed-in user). Must be omitted when deliveryMethod is DOWNLOAD.
Restrict the report to this ISO-3166 country code. Required when reportType is COLLECTED.
Restrict the report to this state or province code. When reportType is COLLECTED, FD (federal nexus sentinel) is not applied as a state filter.
Include transactions on or after this date (YYYY-MM-DD).
Include transactions on or before this date (YYYY-MM-DD). Applies to SUMMARY, DETAILS, and COLLECTED.
Include transactions with invalid addresses. Applies to the DETAILS report only; ignored for SUMMARY and COLLECTED.
When reportType is COLLECTED, include credit notes with nonzero imported tax. Ignored for SUMMARY and DETAILS.
Response
Id of the export job. Poll GET /transactions/exports/{exportId} for its status and, for a DOWNLOAD export, its link.
State of the export. QUEUED on a successful request.
QUEUEDPROCESSINGREADYFAILEDHow the report will be delivered.
EMAILDOWNLOADEmail the finished report will be sent to, or null for a DOWNLOAD export.
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 conflicts with existing state.
The request failed validation.