---
title: "Read company reports"
method: GET
path: "/company/reports"
tags: ["Reports"]
---

# Read company reports

`GET /company/reports`

## Request

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

Returns a list of all the company reports with their details. The data is filtered based on the access level of the service user making the call. Only viewable categories are returned.<br /> <br />  <b>Permissions required:</b>  <br /> The service user that you use for this call should have the required permissions to access reports. To learn more, see <a href="https://apidocs.hibob.com/reference/reports" target="_blank">Reports permissions</a>.

## Response `200`

List of reports and their details

- Reports
  - `views` Report[]
    - `modificationDate` string
    - `createdBy` string
    - `configuration` object
      - `instructions` object[]
        - `fieldPath` string
        - `operator` string
        - `values` string[]
      - `changes` string
      - `displayPreferences` object
        - `exportConfiguration` string
        - `includeFlatJson` boolean
        - `dateFormat` string
        - `supportErrorWrapping` boolean
        - `columnsProperties` string
        - `includeHumanReadable` boolean
      - `sortBy` boolean
      - `fields` string[]
      - `excludeSystemChanges` string
    - `isComparable` boolean
    - `name` string
    - `description` string
    - `isScheduled` boolean
    - `id` number
    - `type` string
    - `creationDate` string
    - `folderId` string

## Other responses

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