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

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.net/hibob/apis/employee-data-api.md) · [All operations](https://skmtc.net/hibob/apis/employee-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hibob/employee-data-api/revisions/0781ebbdda91/schema)