---
title: "Get the report download URL for polling"
method: GET
path: "/company/reports/{reportId}/download-async"
tags: ["Reports"]
---

# Get the report download URL for polling

`GET /company/reports/{reportId}/download-async`

## Request

- Base URL: `https://api.hibob.com/v1`
- URL: `https://api.hibob.com/v1/company/reports/{reportId}/download-async`
- Auth: one of:
  - HTTP basic
  - HTTP bearer

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>.

## Path parameters

- `reportId` number, required

## Query parameters

- `format` 'csv' | 'xlsx', required
- `includeInfo` boolean
- `locale` string
- `humanReadable` string

## Response `200`

Report URL under "Location" in the response header.

## Other responses

- `202`: Accepted - Report generation started
- `400`: Bad Request
- `401`: Unauthorized
- `404`: Not Found
- `429`: Rate limit exceeded
- `500`: Internal server error

---

[API](https://skmtc.dev/hibob/apis/reports-api.md) - [All operations](https://skmtc.dev/hibob/apis/reports-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hibob/apis/reports-api/revisions/aec2bad6d17f?raw)