Timesheet
List timesheets with filtering and pagination
Search and retrieve a list of timesheets with comprehensive filtering options.
This endpoint allows you to:
- List all timesheets for specific employees or companies
- Filter by timesheet status (OPEN, SUBMITTED, APPROVED, REJECTED)
- Filter by date ranges
- Search by employee name
- Sort results by various fields
- Paginate through large result sets
Use this endpoint to view timesheet history, find pending approvals, or generate reports.
get/v1/timesheets
Query parameters
pageinteger
Example:1
Page number (1-indexed)
pageSizeinteger
Example:20
Number of items per page
employeeIdsstring[]
Filter timesheets by employee IDs (employment IDs). Can specify multiple values.
status'OPEN' | 'PARTIALLY_SUBMITTED' | 'SUBMITTED' | 'APPROVED' | 'REJECTED'
Filter by timesheet status
startDateFromstring date
Filter timesheets with start date from this date (inclusive)
startDateTostring date
Filter timesheets with start date up to this date (inclusive)
memberNamestring
Filter timesheets by employee name (partial match, case-insensitive)
companyIdsstring[]
Filter timesheets by company IDs. Can specify multiple values.
countrystring
Filter timesheets by country code (ISO 3166-1 alpha-3)
sortBy'startDate' | 'endDate' | 'updatedOn' | 'submittedOn' | 'approvedOn'
Field to sort by
sortOrder'ASC' | 'DESC'
Sort direction
Response
Timesheets retrieved successfully
Example response
{
"data": [
{
"timesheetId": "TS-001",
"employeeId": "123e4567-e89b-12d3-a456-426614174000",
"startDate": "2025-10-01",
"endDate": "2025-10-31",
"status": "APPROVED",
"totalDays": 31,
"totalSubmittedDays": 22,
"totalApprovedDays": 22,
"totalTimeInMinutes": 10560,
"submittedOn": "2025-11-01T09:00:00Z",
"approvedOn": "2025-11-02T14:30:00Z",
"updatedOn": "2025-11-02T14:30:00Z"
}
],
"pagination": {
"page": 1,
"pageSize": 20,
"totalCount": 100,
"totalPages": 5
}
}