---
title: "Download most recent report file"
method: GET
path: "/reports/{reportId}/files/recent/data"
tags: ["reports"]
---

# Download most recent report file

`GET /reports/{reportId}/files/recent/data`

## Request

- Base URL: `https://api.smartrecruiters.com/reporting-api/v201804`
- URL: `https://api.smartrecruiters.com/reporting-api/v201804/reports/{reportId}/files/recent/data`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://www.smartrecruiters.com/identity/oauth/allow`
    - Client credentials
    - Token URL: `https://api.smartrecruiters.com/identity/oauth/token` scopes: `reporting_read`
  - API key in header `x-smarttoken`

Use this endpoint to download the most recent report file for a specific report. The response contains report data in CSV format. In order to get a successful response, there have to be at least 1 successfully generated report file for the report.
### Etags
Along with the successful response, the `Etag` HTTP header is returned, containing ETag identifier of the report file. In order to save bandwidth resources, the `If-None-Match HTTP` header containing the recently retrieved report file ETag can be passed with the request. If there's no report file, that is newer than the one referred in the `If-None-Match` header, the API responds with HTTP `304 Not Modified` status code and does not provide content.
### Note
It is not recommended to attempt downloading large report files via Live Docs or Internet Browser. To get a large report file, use command line tools or native HTTP clients.

## Path parameters

- `reportId` string, required

## Headers

- `If-None-Match` string

## Response `200`

Successful response.

## Other responses

- `304`: Returned when there's no newer report file available.
- `400`: Returned when the report ID is invalid or an invalid value for the If-Match/If-None-Match header was provided.
- `401`: Returned when a request was not authenticated.
- `403`: Returned when a caller is not authorized to download the report file.
- `404`: Returned when there is no successfully generated report file.
- `412`: Returned when the provided value for the If-Match header doesn't match.

---

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