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

# Get report files

`GET /reports/{reportId}/files`

## Request

- Base URL: `https://api.smartrecruiters.com/reporting-api/v201804`
- URL: `https://api.smartrecruiters.com/reporting-api/v201804/reports/{reportId}/files`
- 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 fetch a list of report files of a specific report. Report files are sorted by generation date (newer report files first).
### Paging
Whenever there's more data to be returned, the `nextPage` property will contain an opaque identifier of the next page. The value can be then passed as a page query parameter in a subsequent request. Another option is to use the response's `Link` HTTP header, which contains a web link to the following page, example:
```
<https://api.smartrecruiters.com/reporting-api/v201804/reports/{reportId}/files?page=MjEyMy0wMS0wMVQwMDowMDowMC4xMjFaO2Q7MDg4MjY4MWItOTIzYi00ZTIwLWIwMDctY2Y0Y2I0YTM5ODRi>; rel="link"
```

## Path parameters

- `reportId` string, required

## Query parameters

- `page` string
- `limit` integer

## Response `200`

Successful response.

- ApiReportFilesResponse
  - `nextPage` string
  - `content` 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

- `400`: Returned when the report ID, page parameter or limit parameter is invalid.
- `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 report with the given ID.

---

[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)