Query parameters

• fromDate string

  Optional date in ISOString to filter by the weekStart field. Gets converted to start of ISO week. Defaults to start of ISO week of 1 week in the past. Note: The difference of fromDate and toDate cannot exceed 2 weeks.

• toDate string

  Required if fromDate is provided. Date in ISOString to filter by the weekEnd field. Gets converted to end of ISO week. Defaults to end of ISO week of today. Note: The difference of fromDate and toDate cannot exceed 2 weeks.

• status string

  One or more statuses to filter the timesheets by.

• type string

  The timesheet type to filter timesheets by. That is, either company or project.

• updatedAt string

  A date query to filter the results by the last updatedAt field. Format is [operation] [date], e.g. updatedAt=gt 2025-02-24T00:00:00.000Z. Acceptable operations are lt = lower than, lte = lower than or equal, gt = greater than, gte = greater than or equal. The date is in ISOString.

• person string

  Filter the results by a single person.

• select array[string]

  One or more properties to be included in the response, instead of the full payload. E.g. select=clients,departments

Responses

• 200 application/json

  Successful response

  Hide response attribute Show response attribute object

  • value array[object]
    One of:

    TimesheetCompany object TimesheetProject object

    Hide attributes Show attributes

    • _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().

    • updatedAt string(date-time)

      The date the document was last updated in ISOString format. See .toISOString().

    • type string Required Discriminator

      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.

      Value is company.

    • status string

      The current status of the timesheet. Defaults to draft.

      Values are draft, submitted, approved, or rejected.

    • customId string

      A custom identifier for internal reference by your system (not used by missionX).

    • weekOfDate string Required

      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().

    • weekStart string

      The start date (Monday start of day) of the timesheets week in ISOString format.

    • weekEnd string

      The end date (Sunday end of day) of the timesheets week in ISOString format.

    • person string Required

      The _id of the person that the hours are submitted for. This is the org.people[].person value.

    • entries array[object] Required

      A list of timesheet entries.

      Hide entries attributes Show entries attributes object

      • description string Required

        Free form description (title) for this timesheet.

      • hours array[object] Required

        The hours to be submitted for this entry.

        Hide hours attributes Show hours attributes object

        • day string

          The 3-letter formatted day of the week that the hours are submitted for.

          Values are MON, TUE, WED, THU, FRI, SAT, or SUN.

        • value number(float)

          The amount of hours to be submitted. Float values are supported. E.g. 2 hours => 2, 2 and a half hours => 2.5

      • codeId string

        The timesheet code id as specified in the organization settings. This is the org.timesheetCodes[].id value.

    Hide attributes Show attributes

    • _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().

    • updatedAt string(date-time)

      The date the document was last updated in ISOString format. See .toISOString().

    • type string Required Discriminator

      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.

      Value is project.

    • status string

      The current status of the timesheet. Defaults to draft.

      Values are draft, submitted, approved, or rejected.

    • customId string

      A custom identifier for internal reference by your system (not used by missionX).

    • weekOfDate string Required

      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().

    • weekStart string

      The start date (Monday start of day) of the timesheet's week in ISOString format.

    • weekEnd string

      The end date (Sunday end of day) of the timesheet's week in ISOString format.

    • planItem string Required

      Available and required only for type project. The _id of the planItem (role) that the hours are submitted for. This is the project.planItems[]._id value.

    • project string

      Available only for type project. The _id of the project that the planItem (role) specified belongs to. This is the project._id value.

    • entries array[object] Required

      A list of timesheet entries.

      Hide entries attributes Show entries attributes object

      • description string Required

        Free form description (title) for this timesheet.

      • hours array[object] Required

        The hours to be submitted for this entry.

        Hide hours attributes Show hours attributes object

        • day string

          The 3-letter formatted day of the week that the hours are submitted for.

          Values are MON, TUE, WED, THU, FRI, SAT, or SUN.

        • value number(float)

          The amount of hours to be submitted. Float values are supported. E.g. 2 hours => 2, 2 and a half hours => 2.5

      • codeId string

        Optional. The timesheet code id as specified in the organization settings. This is the org.timesheetCodes[].id value.

      • taskId string

        Optional. The _id of the task. To be provided if the hours are submitted against a task. If provided, the task needs to belong to the planItem specified for this timesheet.