Approve timesheet

The approval and decline processes are generally the same. You can approve or decline an entire timesheet or only portions of it (individual days).

A partially approved or declined timesheet includes a mix of approved or declined and submitted time entries. The last action determines whether the timesheet status appears as partially approved or declined. For example, if you last approved entries, the timesheet appears as partially approved; if you last declined entries, the timesheet appears as partially declined.

List timesheets to approve

get/objects/time/timesheet-to-approve

Returns a collection with a key, ID, and link for each timesheet to approve. This operation is mostly for use in testing; use the query service to find objects that meet certain criteria and to specify properties that are returned.

SecurityOAuth2
Responses
200

OK

400

Bad Request

Request samples
Response samples
application/json
{
  • "ia::result": [
    • {
      • "key": "101",
      • "id": "101",
      • "href": "/objects/time/timesheet-to-approve/101"
      },
    • {
      • "key": "102",
      • "id": "102",
      • "href": "/objects/time/timesheet-to-approve/102"
      },
    • {
      • "key": "103",
      • "id": "103",
      • "href": "/objects/time/timesheet-to-approve/103"
      }
    ],
  • "ia::meta": {
    • "totalCount": 3,
    • "totalSuccess": 3,
    • "totalError": 0,
    • "start": 1,
    • "pageSize": 100,
    • "next": 0,
    • "previous": 0
    }
}

Get a timesheet to approve

get/objects/time/timesheet-to-approve/{key}

Returns detailed information for a specified timesheet to approve.

SecurityOAuth2
Request
path Parameters
key
required
string

system-assigned unique key for the timesheet-to-approve.

Example: 99
Responses
200

OK

400

Bad Request

Request samples
Response samples
application/json
{
  • "ia::result": {
    • "key": "23",
    • "id": "23",
    • "href": "/objects/projects/timesheet/23",
    • "beginDate": "2025-01-01",
    • "endDate": "2025-01-07",
    • "postingDate": "2025-01-07",
    • "state": "submitted",
    • "unitOfMeasure": "Hours",
    • "hoursInDay": 8,
    • "billableQuantity": 40,
    • "nonBillableQuantity": 2,
    • "description": "Week of 2025-01-01",
    • "calculationMethod": "hourly",
    • "postActualLaborCost": false,
    • "employee": {
      • "key": "973",
      • "id": "E-001",
      • "href": "/objects/company-config/employee/973"
      },
    • "employeeContact": {
      • "key": "973",
      • "name": "John Smith",
      • "firstName": "John",
      • "lastName": "Smith",
      • "href": "/objects/company-config/contact/973"
      },
    • "attachment": {
      • "key": "8420",
      • "id": "Attach-01",
      • "href": "string"
      },
    • "lines": [
      • {
        }
      ],
    • "audit": {
      • "createdDateTime": "2022-04-20T16:20:00Z",
      • "modifiedDateTime": "2022-04-20T16:20:00Z",
      • "createdBy": "1",
      • "modifiedBy": "95"
      }
    },
  • "ia::meta": {
    • "totalCount": 1,
    • "totalSuccess": 1,
    • "totalError": 0
    }
}