# Developer Docs Documentation

> The Developer Docs is where you'll find comprehensive guides and documentation to help you start working with Bob as quickly as possible.

Fetch the complete documentation index at: https://apidocs.hibob.com/llms.txt. Use this file to discover all available pages before exploring further. Append .md to any documentation page URL to get its markdown version.

## API Reference: Reports API
- [Reports](https://apidocs.hibob.com/reference/reports.md): The Reports API provides access to the details of your company reports.
- [Read company reports](https://apidocs.hibob.com/reference/get_company-reports.md): Returns a list of all the company reports with their details. The data is filtered based on the access level of the service user making the call. Only viewable categories are returned.<br /> <br />  <b>Permissions required:</b>  <br /> The service user that you use for this call should have the required permissions to access reports. To learn more, see [Reports permissions](https://apidocs.hibob.com/reference/reports).
- [Download the report by ID](https://apidocs.hibob.com/reference/get_company-reports-reportid-download.md): Returns a report data file in the specified format.<br /> <b>Supported user types:</b> Service. <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 [Reports permissions](https://apidocs.hibob.com/reference/reports).
- [Get the report download URL for polling](https://apidocs.hibob.com/reference/get_company-reports-reportid-download-async.md): 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 ([Download report file by URL](https://apidocs.hibob.com/reference/get_company-reports-download-reportname)):<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 [Reports permissions](https://apidocs.hibob.com/reference/reports).
- [Download a report by the report name.](https://apidocs.hibob.com/reference/get_company-reports-download-reportname.md): Downloads the report that was generated with the Get the report download URL for polling endpoint.<br />  <br />To download the report:<br /> 1. Use the [Get the report download URL for polling](https://apidocs.hibob.com/reference/get_company-reports-reportid-download-async) endpoint to obtain the report URL.<br /> 2. Copy only the name of the report (after the /download/) from the URL returned in the response header, and use it as the `reportName` for download.  <br /><br />For example: `https://app.hibob.com/v1/company/reports/download/2022-06-17T11_22_14.798810-test.JsonFormat`<br /> 3. If you receive 204 error response, this means the reports is not ready yet. In this case you should try again.<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 [Reports permissions](https://apidocs.hibob.com/reference/reports).