---
updatedAt: 2025-07-22T07:42:49.000Z
---
Fetch the complete documentation index at: https://apidocs.hibob.com/llms.txt. Use this file to discover all available pages before exploring further.
# Read company reports
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.
Permissions required:
The service user that you use for this call should have the required permissions to access reports. To learn more, see [Reports permissions](https://apidocs.hibob.com/reference/reports).
# OpenAPI definition
```json
{
"openapi": "3.1.1",
"info": {
"title": "Reports API",
"description": "Use Public API to access Reports in Bob",
"license": {
"name": "Proprietary",
"url": "https://apidocs.hibob.com/docs/api-terms-of-use"
},
"contact": {
"name": "Hi Bob, Inc."
},
"version": "1.0.0"
},
"servers": [
{
"url": "https://api.hibob.com/v1",
"description": "Production"
},
{
"url": "https://api.sandbox.hibob.com/v1",
"description": "Sandbox"
}
],
"x-readme": {
"metrics-enabled": false
},
"paths": {
"/company/reports": {
"get": {
"operationId": "get_company-reports",
"tags": [
"Reports"
],
"summary": "Read company reports",
"description": "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.
Permissions required:
The service user that you use for this call should have the required permissions to access reports. To learn more, see Reports permissions.",
"responses": {
"200": {
"description": "List of reports and their details",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Reports"
}
}
}
},
"400": {
"description": "Bad Request",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ApiErrorResponse"
}
}
}
},
"401": {
"description": "Unauthorized",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ApiErrorResponse"
}
}
}
},
"404": {
"description": "Not Found",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ApiErrorResponse"
}
}
}
},
"429": {
"description": "Rate limit exceeded",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ApiErrorResponse"
}
}
}
},
"500": {
"description": "Internal server error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ApiErrorResponse"
}
}
}
}
},
"security": [
{
"basic": []
},
{
"Bearer": []
}
]
}
}
},
"components": {
"schemas": {
"Report": {
"type": "object",
"properties": {
"modificationDate": {
"type": "string"
},
"createdBy": {
"type": "string"
},
"configuration": {
"type": "object",
"properties": {
"instructions": {
"type": "array",
"items": {
"type": "object",
"properties": {
"fieldPath": {
"type": "string"
},
"operator": {
"type": "string"
},
"values": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
},
"changes": {
"type": "string"
},
"displayPreferences": {
"type": "object",
"properties": {
"exportConfiguration": {
"type": "string"
},
"includeFlatJson": {
"type": "boolean"
},
"dateFormat": {
"type": "string"
},
"supportErrorWrapping": {
"type": "boolean"
},
"columnsProperties": {
"type": "string"
},
"includeHumanReadable": {
"type": "boolean"
}
}
},
"sortBy": {
"type": "boolean"
},
"fields": {
"type": "array",
"items": {
"type": "string"
}
},
"excludeSystemChanges": {
"type": "string"
}
}
},
"isComparable": {
"type": "boolean"
},
"name": {
"type": "string"
},
"description": {
"type": "string"
},
"isScheduled": {
"type": "boolean"
},
"id": {
"type": "number",
"format": "long"
},
"type": {
"type": "string"
},
"creationDate": {
"type": "string"
},
"folderId": {
"type": "string"
}
}
},
"Reports": {
"type": "object",
"properties": {
"views": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Report"
}
}
}
},
"ApiErrorResponse": {
"type": "object",
"properties": {
"key": {
"type": "string",
"description": "The unique identifier of the error."
},
"error": {
"type": "string",
"description": "A human readable error message."
}
}
}
},
"securitySchemes": {
"basic": {
"type": "http",
"scheme": "basic",
"description": "Basic HTTP authentication using service user credentials"
},
"Bearer": {
"type": "http",
"scheme": "bearer",
"bearerFormat": "OAuth 2.0",
"description": "OAuth 2.0 authentication using an Access Token is available for registered partners only. Try It! does not support the full HiBob OAuth flow. You can follow these steps to complete the OAuth 2.0 flow in Postman and then paste the token here."
}
}
}
}
```