USusemultiplier
timesheet

List timesheets with filtering and pagination

Changed on

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

Request

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
  }
}

Changes