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

# Get most recent report file

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

Use this endpoint to get the most recent report file details for a specific report. 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.

## Path parameters

- `reportId` string, required

## Headers

- `If-None-Match` string

## Response `200`

Successful response.

- ApiReportFileResponse
  - `reportFileId` string
  - `reportId` string
  - `reportFileStatus` 'PENDING' | 'RUNNING' | 'COMPLETED' | 'FAILED'
  - `scheduleType` 'AD_HOC' | 'SCHEDULED'
  - `schedulingDate` string, date-time
  - `generationDate` string, date-time
  - `requestorId` string
  - `accessGroupId` string
  - `systemRoleId` string
  - `rowEntityTypeId` string
  - `rowEntityInstanceId` string
  - `columns` ApiColumnResponse[]
    - `entityTypeId` string
    - `entityInstanceId` string
    - `dataPointId` string
    - `dataPointInstanceId` string
    - `dataPointInstanceName` string
    - `dataPointName` string
    - `dataPointType` 'ID' | 'DATE' | 'NUMBER' | 'TEXT' | 'ENUM' | 'BOOLEAN' | 'DECIMAL'
  - `filters` ApiFilterResponse[]
    - `column` ApiColumnResponse
      - `entityTypeId` string
      - `entityInstanceId` string
      - `dataPointId` string
      - `dataPointInstanceId` string
      - `dataPointInstanceName` string
      - `dataPointName` string
      - `dataPointType` 'ID' | 'DATE' | 'NUMBER' | 'TEXT' | 'ENUM' | 'BOOLEAN' | 'DECIMAL'
    - `dateRange` ApiDateRange
      - `from` string, date-time
      - `to` string, date-time
    - `datePeriod` ApiDatePeriod
      - `period` integer, required
      - `unit` 'DAYS' | 'WEEKS' | 'MONTHS' | 'YEARS', required
      - `fullPeriod` boolean
    - `rowValues` ApiRowValues
      - `noneValue` boolean
      - `values` string[], required
    - `booleanValue` ApiBooleanValue
      - `value` boolean
  - `errorReason` 'UNKNOWN' | 'MISSING_ACCESS_GROUP' | 'ACCESS_GROUP_MISMATCH' | 'MISSING_SYSTEM_ROLE' | 'SYSTEM_ROLE_MISMATCH' | 'REPORTING_AREA_RESTRICTED' | 'INCORRECT_ACCESS_CONFIGURATION' | 'MISSING_REPORT_CREATOR_EMPLOYEE' | 'MAX_REPORT_FILE_SIZE_EXCEEDED'
  - `details` ApiReportFileDetailsResponse
    - `size` integer
    - `numberOfRows` integer

## 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 perform the request.
- `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.net/smartrecruiters/apis/apply-api.md) · [All operations](https://skmtc.net/smartrecruiters/apis/apply-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smartrecruiters/apply-api/revisions/449bdc2516c9/schema)