This article is relevant to system admins and IT staff.
This feature is part of our advanced packages. Would you like to use it to make your processes even more efficient? Simply get in touch with your Customer Success Manager – we’d be happy to advise you on the activation options.
What is the Export API?
The finway Expense Export API is a server-side, strictly read-only REST API for the automated export of CSV files. The process is asynchronous. By automatically exporting the standard CSV file, you can then import the information into your own BI platforms.
Prerequisites
The Export API is a paid feature that must be ordered.
IT technical staff are required to set up the API.
To use the API, an API key from finway is required; the key begins with
fwk_live_and can be retrieved by a system administrator in the system settings. The API key is displayed only once and cannot be retrieved again later. The API key is valid for one year and must be renewed upon expiry.The API host URL is provided by finway on a tenant- or environment-specific basis.
How the Export API works
Use
POST /v1/exports/expensesto initiate an export for a company and a date range.Use
GET /v1/exports/expenses/{exportId}to check the status regularly until it reaches ‘done’ or ‘failed’.Retrieve the completed ZIP file containing the CSV file via the download endpoint.
What is exported
Output data is exported in the same technical format as in the standard Finway CSV export.
Filtering is based on the line date.
The result is a ZIP archive containing exactly one CSV file. Optionally, archived requests can be included via
includeArchived.
What is not included
The API does not modify any data in finway and supports only the export of output data.
A maximum of one export per company may be processed at any one time. In the event of concurrent requests,
429 Too Many Requestsis returned.
Technical Reference
Endpoints and Example Payloads
Method and Path | Uses | Successful response |
POST /v1/exports/expenses | Start asynchronous output export. | 202 Accepted with exportId and status: pending |
GET /v1/exports/expenses/{exportId} | Check the status of an export job. | Status pending, done oder failed |
GET /v1/exports/expenses/{exportId}/download | Download the finished export archive. | ZIP archive containing a CSV file |
Request-Felder
Feld | Typ | Beschreibung |
companyId | String | ID of the company on behalf of which the export is being carried out. |
from | String, Date | Start date of the purchase date filter, inclusive; format YYYY-MM-DD. |
to | String, Date | End date of the purchase date filter, inclusive; format YYYY-MM-DD. |
includeArchived | Boolean | Optional: include archived receipts or documents. |
HTTP-Statuscodes und Fehlerbehandlung
Status | Bedeutung und empfohlene Aktion |
400 | Invalid request – please check for missing or incorrectly formatted fields, for example. |
401 | Authentication failed; check the API key and authorisation header. |
403 | The organisation has not been authorised to use the API key, or it has been deactivated. |
404 | Company not found, or no expenses in the selected period. |
422 | The export exceeds the permitted size limit; please reduce the time period. |
429 | An export is already in progress for the company; please note the ‘Retry-After’ message and try again later. |
500 | Internal server error; please try again later or contact Finway Support. |
API key
The API host URL is: https://api.finway.de
The API key is retrieved by a system administrator in the System Settings – API Key section.
The API key is displayed once and cannot be viewed again later.
No more than 2 API keys can be active at any one time.
Expiry: An API key automatically expires 12 months after it is created.
Notifications: The user who created the key will be notified in good time by email of the impending expiry. These reminders are sent 30 days, 7 days and 1 day before the expiry date.
Please find in the appendix the detailed instructions on how technical staff can set up the API.
last updatet, August 20th, 2026