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
string | integer · pattern:^\d+$
· requiredThe unique identifier of the administration
A unique record identifier of an administration
format
string · pattern:^(.(json|xml))?$
· requiredThe format in which the response is given, can be empty to use the default format
Default: .jsonid
string | integer · pattern:^\d+$
· requiredThe download ID
A unique record identifier
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
string | integer · pattern:^\d+$
· requiredThe unique identifier of the administration
A unique record identifier of an administration
format
string · pattern:^(.(json|xml))?$
· requiredThe format in which the response is given, can be empty to use the default format
Default: .json
query Parameters
per_page
integer | string · min: 1 · max: 100 · pattern:^\d+$
page
integer | stringdownload_type
stringFilter downloads by type. Common download types include:
auditfile
brugstaat
export_ledger_account_report
Check the
download_type
field in the response to see all available types.downloaded
boolean | stringfailed
boolean | string
Responses
A list of downloads
id
string | integer · pattern:^\d+$
A unique record identifier
user_id
string | integer | null · pattern:^\d+$
A unique record identifier
download_type
stringThe type of download (e.g., export_contacts, export_sales_invoices, auditfile)
filename
stringcontent_type
stringfailed
booleandownloaded
booleancreated_at
string · date-timeupdated_at
string · date-time