---
title: "Fetch a summary by filtering timesheets given filters"
method: POST
path: "/timesheet-export/v2/summary:get"
tags: ["Timesheets"]
---

# Fetch a summary by filtering timesheets given filters

`POST /timesheet-export/v2/summary:get`

## Request

- Base URL: `https://your-subdomain.deputy.deputy.com/api`
- URL: `https://your-subdomain.deputy.deputy.com/api/timesheet-export/v2/summary:get`
- Auth: API key in header `OAuth`

Fetch a summary by filtering timesheets given filters.

## Request body

- TimesheetExportSummaryRequest
  - `filters` ModelSummaryFilters
    - `companyPeriods` ModelCompanyPeriods
      - `companyPeriodIds` integer[]
    - `payCalendar` ModelPayCalendarOption
      - `id` integer
      - `startDate` string
      - `endDate` string
    - `dateRange` ModelDateRange
      - `startDate` string
      - `endDate` string
    - `locations` ModelLocations
      - `locationIds` integer[]
    - `payCenters` ModelPayCenters
      - `payCenterIds` integer[]
    - `employeeIds` integer[]
    - `employeeSelectionMode` 'EMPLOYEE_SELECTION_MODE_UNKNOWN' | 'INCLUDE' | 'EXCLUDE'
  - `bulkSelection` ModelSummaryBulkSelection
    - `timesheetIds` integer[]
    - `payCycleIds` integer[]

## Response `200`

A successful response.

- TimesheetExportSummaryResponse
  - `totalEmployees` integer
  - `totalTimesheets` integer
  - `totalHours` string
  - `totalCost` string
  - `summarizedTimesheets` ModelSummarizedTimesheet[]
    - `id` integer
    - `modifiedTimestamp` string
    - `employeeId` integer
  - `summarizedPayCycles` ModelSummarizedTimesheet[]
    - `id` integer
    - `modifiedTimestamp` string
    - `employeeId` integer
  - `startDate` string
  - `endDate` string

---

[API](https://skmtc.dev/deputy/apis/deputy-v2-api.md) - [All operations](https://skmtc.dev/deputy/apis/deputy-v2-api/llms.txt) - [OpenAPI document](https://skmtc.dev/deputy/apis/deputy-v2-api/revisions/78f0278f4608?raw)