Upcoming Change: Currency values in CSV API exports
We wanted to make you aware of an upcoming change to how currency data is returned when accessing Document List CSV exports via the API.
We’ve already updated the frontend so that exporting the Document List as a CSV from the UI includes currency gadget values as currency (for example, dollars). Previously, currency gadgets exported as cents in the CSV (for example, $3.10exported as 310).
What’s changing for API exports
We’re now extending this same behavior to CSV exports accessed via the API.
- The CSV export endpoint is not changing.
- The output behavior is changing from exporting currency values as cents to retaining the actual currency value in the CSV.
We’re sharing this update in advance so you have time to review any scripts, integrations, or processes that consume this endpoint and make any necessary adjustments.
Preview the new behavior
You can preview the new currency format today by adding the useNewCurrencyFormat URL parameter and setting it to true.
Below are example endpoints—replace testhost with your local domain.
Current behavior (exports currency as cents):
https://testhost/app/api/v0/apps/62796f6eb75668508d66a514/62793e95b75668508d663fe8/documents.csv
New behavior (exports currency values):
https://testhost/app/api/v0/apps/62796f6eb75668508d66a514/62793e95b75668508d663fe8/documents.csv?useNewCurrencyFormat=true
Important date
As of February 2, 2026, the CSV export endpoint will default to the new currency format. At that point, the useNewCurrencyFormat parameter will no longer be required.
If you have existing API integrations that consume CSV exports, be sure to update them to handle the new currency output format before this date.
Note: Currency values will continue to be stored as cents in the database. This change only affects how values are represented in the CSV export.