---
title: "Get timesheet reports"
method: GET
path: "/api/v2/reports/timesheet_reports"
tags: ["Reports"]
---

# Get timesheet reports

`GET /api/v2/reports/timesheet_reports`

Retrieve aggregated timesheet report data grouped by configurable dimensions.

## Query parameters

- `group` 'organization' | 'person' | 'week'
- `filter` union — Filter schema for `timesheet_report` list endpoints — pass a single condition or a logical group.
  - object — A logical filter group — combine multiple conditions with the `$op` operator.
    - `$op` 'or' | 'and', required — Logical operator combining conditions in this group. `or` matches records satisfying any condition; `and` requires all conditions to match.
  - FilterTimesheetReport — Available filter parameters for querying aggregated timesheet report data.
    - `person_id` union — Filter timesheet report results by person id.
      - PersonId — unresolved $ref
      - object — Filter operator object for person id.
        - `eq` PersonId — unresolved $ref
        - `contains` PersonId — unresolved $ref
        - `not_eq` PersonId — unresolved $ref
        - `not_contain` PersonId — unresolved $ref
    - `tags` union — Filter timesheet report results by tags.
      - Tags — unresolved $ref
      - object — Filter operator object for tags.
        - `not_eq` Tags — unresolved $ref
        - `not_contain` Tags — unresolved $ref
        - `eq` Tags — unresolved $ref
        - `contains` Tags — unresolved $ref
    - `query` union — Filter timesheet report results by query.
      - object — Filter operator object for query.
        - `contains` Query — unresolved $ref
        - `not_contain` Query — unresolved $ref
        - `eq` Query — unresolved $ref
        - `not_eq` Query — unresolved $ref
      - Query — unresolved $ref
    - `after` union — Filter timesheet report results by after.
      - After — unresolved $ref
      - object — Filter operator object for after.
        - `not_contain` After — unresolved $ref
        - `contains` After — unresolved $ref
        - `not_eq` After — unresolved $ref
        - `eq` After — unresolved $ref
    - `person_status` union — Filter timesheet report results by person status.
      - object — Filter operator object for person status.
        - `contains` PersonStatus — unresolved $ref
        - `not_contain` PersonStatus — unresolved $ref
        - `not_eq` PersonStatus — unresolved $ref
        - `eq` PersonStatus — unresolved $ref
      - PersonStatus — unresolved $ref
    - `before` union — Filter timesheet report results by before.
      - object — Filter operator object for before.
        - `not_eq` Before — unresolved $ref
        - `eq` Before — unresolved $ref
        - `not_contain` Before — unresolved $ref
        - `contains` Before — unresolved $ref
      - Before — unresolved $ref
    - `people_custom_fields` union — Filter timesheet report results by people custom fields.
      - object — Filter operator object for people custom fields.
        - `not_eq` PeopleCustomFields — unresolved $ref
        - `eq` PeopleCustomFields — unresolved $ref
        - `not_contain` PeopleCustomFields — unresolved $ref
        - `contains` PeopleCustomFields — unresolved $ref
      - PeopleCustomFields — unresolved $ref
    - `week_submission_status` union — Filter timesheet report results by week submission status.
      - object — Filter operator object for week submission status.
        - `not_eq` WeekSubmissionStatus — unresolved $ref
        - `contains` WeekSubmissionStatus — unresolved $ref
        - `eq` WeekSubmissionStatus — unresolved $ref
        - `not_contain` WeekSubmissionStatus — unresolved $ref
      - WeekSubmissionStatus — unresolved $ref
- `sort` string[]

## Headers

- `X-Organization-Id` string, required

## Response `200`

Collection timesheet report

---

[API](https://skmtc.dev/productive/apis/api-documentation.md) · [All operations](https://skmtc.dev/productive/apis/api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/productive/api-documentation/revisions/bbf5057edf0d/schema)