---
updatedAt: 2026-06-03T14:36:43.000Z
agentTools:
  projectIndex: https://developer.personio.de/llms.txt
---

# Lists all reports for a company.

Returns a list of reports available for the company. The reports are returned in a sorted order, with the most recent appearing first.

# OpenAPI definition

```json
{
  "openapi": "3.0.3",
  "info": {
    "title": "Public API - Reporting Engine Service",
    "version": "2.0.0",
    "description": "Collection of endpoints to manage the Analytics Report Builder."
  },
  "servers": [
    {
      "url": "https://api.personio.de",
      "description": "Relative url for Public API reporting service v2."
    }
  ],
  "security": [
    {
      "BearerAuth": []
    }
  ],
  "paths": {
    "/v2/reports": {
      "get": {
        "summary": "Lists all reports for a company.",
        "description": "Returns a list of reports available for the company. The reports are returned in a sorted order, with the most recent appearing first.",
        "x-path-examples": {
          "200 List Reports": {
            "value": "/public-api/v2/reports"
          },
          "200 List Reports with name and limit": {
            "value": "/public-api/v2/reports",
            "query": "name=report1&limit=10"
          },
          "200 List Reports with cursor": {
            "value": "/public-api/v2/reports",
            "query": "cursor=eyJvZmZzZXQiOjAsInRhYmxlUXVlcnkiOnsicm93IjoiZW1wbG95ZWUiLCJ"
          },
          "400 Request with invalid limit": {
            "value": "/public-api/v2/reports",
            "query": "limit=xxx"
          }
        },
        "operationId": "listCompanyReports",
        "tags": [
          "Reports"
        ],
        "parameters": [
          {
            "name": "name",
            "description": "Search clause to filter by report name.",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "example": "my absences 2025"
            }
          },
          {
            "name": "cursor",
            "description": "An encoded opaque value containing sorting, filtering and pagination parameters. If query parameters are provided in addition to the cursor and limit the request will fail.",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "example": "kLMvcsaXMDdWQ1XREWY="
            }
          },
          {
            "name": "limit",
            "description": "Max number of reports returned in the response. Limit <= 0 returns all reports.",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number",
              "example": 25
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List of reports given a particular query.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ReportsResponse"
                },
                "examples": {
                  "200 List Reports": {
                    "$ref": "#/components/examples/GetListReportResponseExample"
                  },
                  "200 List Reports with cursor": {
                    "$ref": "#/components/examples/GetListReportResponseExample"
                  },
                  "200 List Reports with name and limit": {
                    "$ref": "#/components/examples/GetListReportResponseExample"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400Response"
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "BearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "JWT"
      }
    },
    "responses": {
      "400Response": {
        "description": "Bad Request.",
        "content": {
          "application/problem+json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            },
            "examples": {
              "400 Request with invalid limit": {
                "$ref": "#/components/examples/400ResponseLimitExample"
              }
            }
          }
        }
      }
    },
    "schemas": {
      "ReportsResponse": {
        "title": "Reports List Response",
        "description": "Represents the API response containing an array of report objects and related metadata, such as pagination details.",
        "type": "object",
        "properties": {
          "_data": {
            "$ref": "#/components/schemas/ReportsData"
          },
          "_meta": {
            "$ref": "#/components/schemas/ReportsMeta"
          }
        }
      },
      "ReportsData": {
        "title": "Reports Data Array",
        "description": "An array of individual report information objects, each representing a single report available to the company.",
        "type": "array",
        "items": {
          "$ref": "#/components/schemas/ReportInfo"
        }
      },
      "ReportsMeta": {
        "title": "Reports Response Metadata",
        "description": "Contains metadata related to the reports response, such as total number of reports and pagination links.",
        "type": "object",
        "properties": {
          "links": {
            "type": "object",
            "properties": {
              "self": {
                "type": "string",
                "example": "https://api.personio.de/public-api/v2/reports/083f72d2-c20a-4275-9f6f-80306296e8e1?cursor=36532&limit=10"
              },
              "next": {
                "type": "string",
                "example": "https://api.personio.de/public-api/v2/reports/083f72d2-c20a-4275-9f6f-80306296e8e1?cursor=36562&limit=10"
              }
            }
          }
        }
      },
      "ReportInfo": {
        "title": "Report Info Data",
        "description": "Detailed information about a single report, including its unique identifier, name, creation and modification timestamps, chart type, creator, and sharing status.",
        "type": "object",
        "required": [
          "id",
          "name",
          "person",
          "chart_type"
        ],
        "properties": {
          "id": {
            "type": "string",
            "example": "550e8400-e29b-41d4-a716-446655440000"
          },
          "name": {
            "type": "string",
            "example": "Absences Rate Sep 2023"
          },
          "edited_at": {
            "type": "object",
            "required": [
              "date_time",
              "timezone"
            ],
            "properties": {
              "date_time": {
                "type": "string",
                "description": "Timestamp with UTC offset.",
                "format": "date-time"
              },
              "timezone": {
                "type": "string",
                "description": "Provide a time zone ID that conforms to the [Time Zone Database](https://www.iana.org/time-zones).",
                "example": "Europe/Berlin"
              }
            }
          },
          "created_at": {
            "type": "object",
            "required": [
              "date_time",
              "timezone"
            ],
            "properties": {
              "date_time": {
                "type": "string",
                "description": "Timestamp with UTC offset.",
                "format": "date-time"
              },
              "timezone": {
                "type": "string",
                "description": "Provide a time zone ID that conforms to the [Time Zone Database](https://www.iana.org/time-zones).",
                "example": "Europe/Berlin"
              }
            }
          },
          "last_viewed_at": {
            "type": "object",
            "required": [
              "date_time",
              "timezone"
            ],
            "properties": {
              "date_time": {
                "type": "string",
                "description": "Timestamp with UTC offset.",
                "format": "date-time"
              },
              "timezone": {
                "type": "string",
                "description": "Provide a time zone ID that conforms to the [Time Zone Database](https://www.iana.org/time-zones).",
                "example": "Europe/Berlin"
              }
            }
          },
          "chart_type": {
            "$ref": "#/components/schemas/ChartType"
          },
          "person": {
            "title": "Report creator",
            "type": "object",
            "required": [
              "id"
            ],
            "properties": {
              "id": {
                "type": "string",
                "example": "123"
              }
            }
          },
          "is_shared_with_anyone": {
            "type": "boolean",
            "description": "Indicates whether this report is currently shared with anyone else."
          }
        }
      },
      "ChartType": {
        "type": "string",
        "title": "Report Chart Type",
        "description": "The type of chart used in the report (e.g., treemap, bar, column, donut, line, table).",
        "enum": [
          "treemap",
          "bar",
          "column",
          "donut",
          "line",
          "table"
        ]
      },
      "ErrorResponse": {
        "type": "object",
        "title": "API Error Response",
        "description": "Standardized error response object containing one or more error details.",
        "required": [
          "errors"
        ],
        "properties": {
          "errors": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ApiError"
            }
          }
        }
      },
      "ApiError": {
        "type": "object",
        "title": "API Error Detail",
        "description": "Represents a single error, including status code, error title, unique identifier, and detailed message.",
        "required": [
          "status",
          "title"
        ],
        "properties": {
          "status": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "detail": {
            "type": "string"
          }
        }
      }
    },
    "examples": {
      "400ResponseLimitExample": {
        "value": {
          "errors": [
            {
              "status": "400",
              "title": "Bad Request",
              "id": "400e8400-e29b-41d4-a716-446655440002",
              "detail": "Invalid parameter 'limit': Failed to convert value"
            }
          ]
        }
      },
      "GetListReportResponseExample": {
        "value": {
          "_data": [
            {
              "id": "34552",
              "name": "Absences Rate Sep 2023",
              "last_viewed_at": {
                "date_time": "2023-12-01T22:00:00Z",
                "timezone": "UTC"
              },
              "created_at": {
                "date_time": "2023-12-11T14:50:17Z",
                "timezone": "UTC"
              },
              "edited_at": {
                "date_time": "2023-12-11T14:50:17Z",
                "timezone": "UTC"
              },
              "chart_type": "line",
              "person": {
                "id": "14323"
              },
              "is_shared_with_anyone": false
            },
            {
              "id": "34553",
              "name": "Sales Performance Oct 2023",
              "created_at": {
                "date_time": "2023-12-11T14:50:17Z",
                "timezone": "UTC"
              },
              "edited_at": {
                "date_time": "2023-12-11T14:50:17Z",
                "timezone": "UTC"
              },
              "last_viewed_at": {
                "date_time": "2023-12-15T22:00:00Z",
                "timezone": "UTC"
              },
              "chart_type": "bar",
              "person": {
                "id": "3890"
              },
              "is_shared_with_anyone": false
            },
            {
              "id": "34554",
              "name": "Employee Satisfaction Nov 2023",
              "created_at": {
                "date_time": "2023-12-11T14:50:17Z",
                "timezone": "UTC"
              },
              "edited_at": {
                "date_time": "2023-12-11T14:50:17Z",
                "timezone": "UTC"
              },
              "last_viewed_at": {
                "date_time": "2023-06-01T22:00:00Z",
                "timezone": "UTC"
              },
              "chart_type": "donut",
              "person": {
                "id": "17765"
              },
              "is_shared_with_anyone": false
            },
            {
              "id": "34555",
              "name": "Productivity Report Dec 2023",
              "created_at": {
                "date_time": "2023-12-11T14:50:17Z",
                "timezone": "UTC"
              },
              "edited_at": {
                "date_time": "2023-12-11T14:50:17Z",
                "timezone": "UTC"
              },
              "last_viewed_at": {
                "date_time": "2023-04-01T22:00:00Z",
                "timezone": "UTC"
              },
              "chart_type": "treemap",
              "person": {
                "id": "19876"
              },
              "is_shared_with_anyone": false
            },
            {
              "id": "34556",
              "name": "Financial Analysis Jan 2024",
              "created_at": {
                "date_time": "2023-12-11T14:50:17Z",
                "timezone": "UTC"
              },
              "edited_at": {
                "date_time": "2023-12-11T14:50:17Z",
                "timezone": "UTC"
              },
              "last_viewed_at": {
                "date_time": "2023-05-01T22:00:00Z",
                "timezone": "UTC"
              },
              "chart_type": "table",
              "person": {
                "id": "11234"
              },
              "is_shared_with_anyone": true
            }
          ],
          "_meta": {
            "links": {
              "self": "https://api.personio.de/public-api/v2/reports?cursor=36532&limit=10",
              "next": "https://api.personio.de/public-api/v2/reports?cursor=36562&limit=10"
            }
          }
        }
      }
    }
  }
}
```