Skip to main content
Use this endpoint to export your transaction history as a downloadable CSV file for regulatory submissions, internal audits, or integration with your compliance reporting pipeline. You can filter the export by date range, payment method, and compliance status, and choose from three output modes depending on how much detail you need.

Endpoint

POST https://api.centsless.org/api/v1/export

Authentication

All requests require an x-api-key header.

Request body

export_mode
string
Controls how many fields are included in the output. Defaults to standard. See the table below for details.
start_date
string
The start of the date range to export, in ISO 8601 datetime format. Example: 2026-01-01T00:00:00Z
end_date
string
The end of the date range to export, in ISO 8601 datetime format. Example: 2026-03-31T23:59:59Z
payment_method
string
Filter by payment method. Matches the payment_method field on transactions (e.g., cash, card, ebt, mobile).
compliance_status
string
Filter by compliance status. One of: PASS, WARN, FAIL

Export modes

ModeFields includedUse case
standard53 fieldsRegulatory submissions and compliance audits
fullAll available fieldsComplete data export for internal analysis
summaryKey fields onlyQuick overview or executive reporting

Code example

curl -X POST https://api.centsless.org/api/v1/export \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "export_mode": "standard",
    "start_date": "2026-01-01T00:00:00Z",
    "end_date": "2026-03-31T23:59:59Z",
    "compliance_status": "PASS"
  }' \
  --output transactions.csv

Response

The response body is a text/csv file download. The Content-Type header will be text/csv. Use --output in curl or the appropriate stream handler in your HTTP client to write the file to disk.