Downloads are files that have been generated as exports from your administration. These can be CSV exports of contacts, sales invoices, time entries, or various financial reports. Use these endpoints to retrieve a list of available downloads and to download the files.
Download a file
Returns a redirect to the actual file download URL.
The user must have the appropriate permissions to access the download based on its type.
The response is a 302 redirect. The client should follow the Location header to download the actual file. The link is valid for 30 seconds.
path Parameters
administration_id^\d+$ · requiredThe unique identifier of the administration
A unique record identifier
format^(.(json|xml))?$ · requiredThe format in which the response is given, can be empty to use the default format
id^\d+$ · requiredThe download ID
A unique record identifier
Download a file › Responses
Found
List all downloads
Returns a paginated list of all downloads in the administration.
Only downloads that the authenticated user has permission to access will be returned, based on the download type and the user's permissions within the administration.
path Parameters
administration_id^\d+$ · requiredThe unique identifier of the administration
A unique record identifier
format^(.(json|xml))?$ · requiredThe format in which the response is given, can be empty to use the default format
query Parameters
per_page^\d+$pagedownload_typeFilter downloads by type. Common download types include:
auditfilebrugstaatexport_ledger_account_report
Check the download_type field in the response to see all available types.
downloadedfailedList all downloads › Responses
A list of downloads
id^\d+$A unique record identifier
user_id^\d+$A unique record identifier
download_typeThe type of download (e.g., export_contacts, export_sales_invoices, auditfile)
filenamecontent_typefaileddownloadedcreated_atupdated_at