v1

latestOpenAPI 3.1.1Proprietary2026-07-26184406877.9 KB
Reports

Get the report download URL for polling

This endpoint asynchronously generates a report, based on the specified format. If successful it returns the status Accepted and sets the URL of the newly generated report in the response header under a header called Location.<br /> You can then obtain the report name and pass it to the next endpoint (<a href="https://apidocs.hibob.com/reference/get_company-reports-download-reportname" target="_blank">Download report file by URL</a>):<br /> 1. Click Headers at the bottom of the response to see the URL.<br /> 2. Copy only the name of the report (after the /download/ part) and paste to the reportName for download.<br /> <br /> <b>Permissions required:</b> <br /> The service user that you use for this call should have the required permissions. To learn more, see <a href="https://apidocs.hibob.com/reference/reports" target="_blank">Reports permissions</a>.

get/company/reports/{reportId}/download-async

Path parameters

reportIdnumber required

The ID of the report to download. You can get this from the response of <a href="https://apidocs.hibob.com/reference/get_company-reports" target="_blank">Read company reports ↗</a>, or from the report’s URL in Bob's UI. <br /><br /> <b>Note⚠️:</b> To use this endpoint, replace reportId in the path with a valid report ID from your account. If left blank or set to an invalid ID, the request will return an error.

Query parameters

format'csv' | 'xlsx' required

File format

includeInfoboolean

Should include info

localestring

Requested language for the report columns in the format of the locale (e.g. fr-FR). If this is not provided, the user preferences locale is used.

humanReadablestring

Optional field. Only enforced when <i><b>format</b></i> is <i>json</i>. <br> <b>If not sent:</b> supply machine-readable values only. If you pass an invalid value it will be ignored.<br> <br> Possible values: <br> <br> <b>APPEND</b> - include the additional "humanReadable" JSON node in the response. <br> <br> <b>REPLACE</b> - supply humanReadable values in JSON instead of machine-readable format. <br>

Response

Report URL under "Location" in the response header.