# Get timesheet

**GET /timesheets/{timesheetId}**


Manage timesheets.

## Servers
- https://open.api.missionx.ai/v2: https://open.api.missionx.ai/v2 ()


## Authentication methods
- O auth2


## Parameters

### Path parameters
- **timesheetId** (string)
  The timesheet unique document ID, i.e. `timesheet._id`.



## Responses
### 200
Successful response

#### Body: application/json (object)
- **_id** (string(ObjectId))
  The unique document ID.
- **createdBy** (string(ObjectId))
  The creator's unique document ID.
- **createdAt** (string(date-time))
  The date the document was created in ISOString format. See [.toISOString()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString).
- **updatedAt** (string(date-time))
  The date the document was last updated in ISOString format. See [.toISOString()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString).
- **type** (string)
  The type of timesheet. Examples of a `company` timesheet are short time absence, training and non billable time. Examples of a `project` timesheet are regular hours and meetings.
- **status** (string)
  The current status of the timesheet. Defaults to `draft`.
- **customId** (string)
  A custom identifier for internal reference by your system (not used by missionX).
- **weekOfDate** (string)
  Any date within the week the timesheet is being submitted for, from Monday to Sunday. Internally this is converted to `weekStart` and `weekEnd` dates. E.g. a value of `2025-03-17T19:50:11.241Z` will be converted to `{ weekStart: 2025-03-17T00:00:00.000Z, weekEnd: 2025-03-22T23:59:59.999Z }`. The value must be in ISOString format. See [.toISOString()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString).
- **weekStart** (string)
  The start date (Monday start of day) of the timesheets week in [ISOString](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString) format.
- **weekEnd** (string)
  The end date (Sunday end of day) of the timesheets week in [ISOString](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString) format.
- **person** (string)
  The `_id` of the person that the hours are submitted for. This is the `people[].person._id` value.
- **entries** (array[object])
  A list of timesheet entries.

### 400
Bad Request

#### Body: application/json (object)
- **message** (string)
  An error message.
- **code** (string)
  An error code to handle specific error responses.
- **data** (object)
  Optionally, additional data to help handle the error.

### 500
Internal Server Error

#### Body: application/json (object)
- **message** (string)
  An error message.
- **code** (string)
  An error code to handle specific error responses.
- **data** (object)
  Optionally, additional data to help handle the error.


[Powered by Bump.sh](https://bump.sh)