---
title: "Start a timesheet"
method: POST
path: "/management/v2/timesheets:start"
tags: ["Timesheets"]
---

# Start a timesheet

`POST /management/v2/timesheets:start`

## Request

- Base URL: `https://your-subdomain.deputy.deputy.com/api`
- URL: `https://your-subdomain.deputy.deputy.com/api/management/v2/timesheets:start`
- Auth: API key in header `OAuth`

Start a timesheet.

## Query parameters

- `id` string

## Request body

- ModelStartTimesheetRequest
  - `recordIP` boolean
  - `areaId` integer
  - `employeeComment` string
  - `customFields` Tenantsharedv2modelCustomField[]
    - `id` string, int64
    - `booleanField` ModelBooleanField
      - `value` boolean
    - `stringField` ModelStringField
      - `value` string
    - `listField` ModelListField
      - `value` string
    - `multiListField` ModelMultiListField
      - `value` string[]
    - `fileField` ModelFileField
      - `value` integer
    - `employeeVisible` boolean
  - `fileId` integer
  - `employeeId` integer
  - `geoLocation` ModelGeoLocation
    - `latitude` number, double
    - `longitude` number, double
    - `accuracy` number, double

## Response `200`

A successful response.

- TimesheetsActionResponse
  - `success` boolean
  - `data` ModelTimesheetActionResponse
    - `managerNotified` boolean
    - `id` integer
    - `employeeId` integer
    - `start` string
    - `end` string
    - `mealBreakSlots` ModelMealBreak[]
      - `type` 'MEAL_BREAK' | 'REST_BREAK'
      - `start` string
      - `end` string
      - `state` 'NOT_START' | 'IN_PROGRESS' | 'FINISHED' | 'DURATION_ONLY' | 'DURATION_FINISHED'
    - `totalTime` number, float
    - `shiftId` integer
    - `employeeComment` string
    - `disputed` boolean
    - `timeApproved` boolean
    - `area` Tenanttimesheetv2modelArea
      - `id` integer
      - `name` string
      - `locationId` integer
      - `locationName` string
    - `inProgress` boolean
    - `autoRounded` boolean
    - `fileId` integer
    - `children` ModelChildTimesheet[]
      - `start` string
      - `end` string
      - `areaId` integer
      - `id` integer
      - `areaName` string
      - `locationId` integer
      - `locationName` 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)