v1

latestOpenAPI 3.0.32026-08-0613775357.6 KB
approvals

List approvals

Lists all submitted time entry and expense item approvals for the organization.

A more typical scenario is to include approvals when getting time entries or expense items by specifying fields=approvals as a query parameter on the respective endpoints.

get/approvals

Query parameters

per_pageinteger

The maximum number of items to show per response page.

Example:100
pageinteger

The response page to return.

Example:2
fields'approvables'

If set to approvables, includes the full detail of the approved TimeEntry or ExpenseItem in the response.

Response

A paginated list of approval records.

Example response

{
  "paging": {
    "per_page": 100,
    "page": 1,
    "previous": "/api/v1/users?per_page=1000&page=1",
    "self": "/api/v1/users?per_page=1000&page=2",
    "next": "/api/v1/users?per_page=1000&page=3"
  },
  "data": [
    {
      "id": 890,
      "status": "pending",
      "approvable_id": 123,
      "approvable_type": "TimeEntry",
      "submitted_by": 8,
      "submitted_at": "2016-10-13T20:16:40Z"
    }
  ]
}