List Hour Entries
Changed onReturns a paginated list of time tracking hour entries. Supports OData-style filter and sort query parameters. Pagination is page-based via page and pageSize (defaults: page 1, pageSize 50, min 10, max 200). Filterable fields: timesheetId, employeeId, date. Sortable fields: date, updatedAt. Default sort is date desc.
OAuth Scopes: time_tracking:timesheets
Request
- Base URLhttps://companySubDomain.bamboohr.com
- Auth
- HTTP basic
- or OAuth 2Authorization code/authorize.phpToken URL/token.phpScopestime_tracking:timesheets
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Query parameters
OData v4 filter expression. Supported operators: eq, ge, le, and. Filterable fields: timesheetId, employeeId, date. Examples: employeeId eq 40342, date ge 2025-01-01 and date le 2025-01-31, timesheetId eq 9001.
Sort expression like date desc or updatedAt asc. Allowed fields: date, updatedAt. Defaults to date desc.
The page number to retrieve. Defaults to 1.
The number of items per page. Defaults to 50, minimum 10, maximum 200.
Response
A paginated list of hour entries.
Example response
{
"meta": {
"totalItems": 125,
"totalPages": 3,
"page": 1,
"pageSize": 50
},
"data": [
{
"id": 101,
"employeeId": 40342,
"timesheetId": 9001,
"date": "2025-01-15",
"hours": 8,
"createdAt": "2025-01-15T18:30:00Z",
"updatedAt": "2025-01-16T10:00:00Z"
}
]
}Changes
- info
endpoint added
- info