> ## Documentation Index
> Fetch the complete documentation index at: https://docs.centsless.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Export transaction data for compliance reporting

> Use the Centsless export endpoint to generate a 53-field CSV covering the complete transaction lifecycle. Filter by date, payment method, and compliance status.

The Centsless export endpoint produces a compliance-ready CSV for regulatory submissions and audit evidence. The standard export includes 53 fields covering every stage of the transaction lifecycle — from the original amounts and rounding calculation through compliance status, fraud score, and audit hash. You can filter exports by date range, payment method, and compliance status to target exactly the records a regulator or auditor needs.

## Export modes

The `export_mode` field controls how many fields are included in the output:

| Mode       | Fields          | Best for                                          |
| ---------- | --------------- | ------------------------------------------------- |
| `standard` | 53 fields       | Regulatory submissions and compliance reporting   |
| `full`     | All fields      | Internal audits where complete raw data is needed |
| `summary`  | Key fields only | Quick operational reviews                         |

## Filter options

You can narrow the export using any combination of these fields:

| Field               | Type      | Description                                             |
| ------------------- | --------- | ------------------------------------------------------- |
| `start_date`        | date-time | Start of the date range (ISO 8601)                      |
| `end_date`          | date-time | End of the date range (ISO 8601)                        |
| `payment_method`    | string    | Filter by payment method (e.g., `cash`)                 |
| `compliance_status` | string    | Filter by compliance status (`PASS`, `WARN`, or `FAIL`) |

## Example export request

```bash theme={null}
curl -X POST https://api.centsless.org/api/v1/export \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "export_mode": "standard",
    "start_date": "2026-01-01T00:00:00Z",
    "end_date": "2026-01-31T23:59:59Z"
  }'
```

The response is a CSV file download with `Content-Type: text/csv`. Save the response body directly to a `.csv` file for use in your reporting tools or submission package.

<Tip>
  For regulatory submissions, use `standard` mode — the 53-field output meets the data requirements of enacted state legislation. For internal audits where you want every raw field the engine stores, use `full` mode.
</Tip>

<Note>
  Combine the CSV export with the hash chain verification endpoint (`GET /admin/verify-hash-chain`) to give regulators tamper-proof evidence. The verification response confirms that every record in your export is part of an unbroken cryptographic chain, which demonstrates the audit trail has not been altered.
</Note>
