---
title: "Get Employees"
method: GET
path: "/v1/matters/{matter_id}/employees"
tags: ["employees"]
---

# Get Employees

`GET /v1/matters/{matter_id}/employees`

## Request

- Base URL: `https://api.ender.au` (the document declares no server; this is the origin it was published from)
- URL: `https://api.ender.au/v1/matters/{matter_id}/employees`
- Auth: HTTP bearer

## Path parameters

- `matter_id` string, uuid, required

## Response `200`

Successful Response

- EmployeesOverviewPage
  - `workbook` WorkbookRead, required
    - `lock_version` integer, required
    - `employer_legal_name` string, nullable, required
    - `employer_abn` string, nullable, required
    - `completed_by` string, nullable, required
    - `administration_date` string, date, nullable, required
    - `liquidation_date` string, date, nullable, required
    - `continuous_administration` boolean, required
    - `continuous_administration_confirmed` boolean, required
    - `id` string, uuid, nullable, required
    - `is_stale` boolean, required
    - `calculated_at` string, date-time, nullable, required
  - `employees` EmployeeRead[], required
    - `employee_number` string, nullable, required
    - `first_name` string, required
    - `last_name` string, required
    - `email` string, nullable, required
    - `classification` string, nullable, required
    - `employment_type` 'unknown' | 'employee' | 'apprentice' | 'trainee' | 'subcontractor' | 'tcf_outworker', required
    - `basis_of_employment` 'unknown' | 'full_time_permanent' | 'part_time_permanent' | 'casual' | 'shiftwork' | 'probation' | 'other', required
    - `state_employed` 'unknown' | 'ACT' | 'NSW' | 'SA' | 'VIC' | 'QLD' | 'NT' | 'TAS' | 'WA', required
    - `relationship_type` 'unknown' | 'none' | 'director' | 'parent' | 'grandparent' | 'sibling' | 'child' | 'grandchild' | 'spouse' | 'other', required
    - `include_in_feg_workbook` boolean, nullable, required
    - `start_date` string, date, nullable, required
    - `termination_date` string, date, nullable, required
    - `termination_type` 'notification' | 'no_notification' | 'resignation', nullable, required
    - `notification_date` string, date, nullable, required
    - `date_of_birth` string, date, nullable, required
    - `hourly_rate` string, decimal, nullable, required
    - `average_weekly_hours` string, decimal, nullable, required
    - `weekly_allowances` string, decimal, nullable, required
    - `total_outstanding_wages` string, decimal, nullable, required
    - `superannuation_owed` string, decimal, nullable, required
    - `unpaid_wages` string, decimal, nullable, required
    - `unpaid_allowances` string, decimal, nullable, required
    - `unpaid_commission` string, decimal, nullable, required
    - `other_unpaid` string, decimal, nullable, required
    - `unpaid_wages_comments` string, nullable, required
    - `annual_leave_hours` string, decimal, nullable, required
    - `annual_leave_winding_up_cost` string, decimal, nullable, required
    - `annual_leave_comments` string, nullable, required
    - `annual_leave_loading_rate` string, decimal, nullable, required
    - `leave_loading_winding_up_cost` string, decimal, nullable, required
    - `leave_loading_comments` string, nullable, required
    - `long_service_leave_hours` string, decimal, nullable, required
    - `long_service_leave_winding_up_cost` string, decimal, nullable, required
    - `long_service_leave_comments` string, nullable, required
    - `notice_weeks` string, decimal, nullable, required
    - `notice_winding_up_cost` string, decimal, nullable, required
    - `notice_comments` string, nullable, required
    - `redundancy_weeks` string, decimal, nullable, required
    - `redundancy_winding_up_cost` string, decimal, nullable, required
    - `redundancy_comments` string, nullable, required
    - `pat_unpaid_wages` string, decimal, nullable, required
    - `pat_annual_leave` string, decimal, nullable, required
    - `pat_long_service_leave` string, decimal, nullable, required
    - `pat_notice` string, decimal, nullable, required
    - `pat_redundancy` string, decimal, nullable, required
    - `payments_after_termination_comments` string, nullable, required
    - `id` string, uuid, required
    - `source_kind` 'manual' | 'xero' | 'generic_excel', required
    - `version` integer, required
    - `updated_at` string, date-time, nullable, required
    - `review_issues` EmployeeReadIssue[], required
      - `code` string, required
      - `message` string, required
      - `field` union, required
        - 'first_name' | 'last_name' | 'date_of_birth' | 'employment_type' | 'basis_of_employment' | 'state_employed' | 'relationship_type' | 'start_date' | 'termination_date' | 'termination_type' | 'notification_date' | 'hourly_rate' | 'average_weekly_hours' | 'weekly_allowances' | 'total_outstanding_wages' | 'unpaid_wages' | 'unpaid_allowances' | 'unpaid_commission' | 'other_unpaid' | 'unpaid_wages_comments' | 'annual_leave_hours' | 'annual_leave_winding_up_cost' | 'annual_leave_comments' | 'annual_leave_loading_rate' | 'leave_loading_winding_up_cost' | 'leave_loading_comments' | 'long_service_leave_hours' | 'long_service_leave_winding_up_cost' | 'long_service_leave_comments' | 'notice_weeks' | 'notice_winding_up_cost' | 'notice_comments' | 'redundancy_weeks' | 'redundancy_winding_up_cost' | 'redundancy_comments' | 'pat_unpaid_wages' | 'pat_annual_leave' | 'pat_long_service_leave' | 'pat_notice' | 'pat_redundancy' | 'payments_after_termination_comments'
        - 'superannuation_owed'
        - 'include_in_feg_workbook'
      - `kind` 'correction' | 'confirmation' | 'classification', required
      - `blocking` boolean, required
    - `source_retrieved_at` string, date-time, nullable, required
    - `supporting_payroll_evidence` XeroPayrollEvidence, required: Recorded payroll support only; never an outstanding FEG input.
      - `from_date` string, date, nullable, required
      - `to_date` string, date, nullable, required
      - `pay_run_count` integer, required
      - `payslip_count` integer, required
      - `ordinary_earnings` string, decimal, required
      - `overtime` string, decimal, required
      - `allowances` string, decimal, required
      - `commission` string, decimal, required
      - `leave_paid` string, decimal, required
      - `other_earnings` string, decimal, required
      - `gross_earnings` string, decimal, required
      - `current_hourly_rate` string, decimal, nullable, required
      - `current_weekly_hours` string, decimal, nullable, required
      - `current_weekly_allowances` string, decimal, nullable, required
      - `current_weekly_allowances_comparable` boolean, required
      - `current_annual_salary` string, decimal, nullable, required
      - `hourly_rate_basis` 'rate_per_unit' | 'annual_salary_conversion' | 'recent_payslip', nullable, required
      - `residential_state_suggestion` 'unknown' | 'ACT' | 'NSW' | 'SA' | 'VIC' | 'QLD' | 'NT' | 'TAS' | 'WA', nullable, required
      - `termination_reason_suggestion` string, nullable, required
      - `leave_loading_eligible` boolean, nullable, required
      - `observed_hourly_rate` string, decimal, nullable, required
      - `average_ordinary_hours_per_week` string, decimal, nullable, required
      - `periods` XeroPayrollPeriodEvidence[], required
        - `pay_run_reference` string, required
        - `payslip_reference` string, required
        - `period_start` string, date, required
        - `period_end` string, date, required
        - `payment_date` string, date, nullable, required
        - `ordinary_hours` string, decimal, required
        - `ordinary_earnings` string, decimal, required
        - `overtime_hours` string, decimal, required
        - `overtime` string, decimal, required
        - `allowances` string, decimal, required
        - `commission` string, decimal, required
        - `leave_paid` string, decimal, required
        - `other_earnings` string, decimal, required
        - `gross_earnings` string, decimal, required
        - `observed_hourly_rates` string[], required
        - `leave` XeroPayrollLeaveEvidence[], required
          - `category` 'annual_leave' | 'long_service_leave' | 'other', required
          - `source_reference` string, nullable, required
          - `name` string, required
          - `unit` string, required
          - `current_balance` string, decimal, nullable, required
          - `accrued` string, decimal, required
          - `taken_or_paid` string, decimal, required
          - `paid_amount` string, decimal, required
      - `allowance_items` XeroPayrollAllowanceEvidence[], required
        - `name` string, required
        - `pay_period_count` integer, required
        - `total_amount` string, decimal, required
        - `latest_amount` string, decimal, required
      - `leave` XeroPayrollLeaveEvidence[], required
        - `category` 'annual_leave' | 'long_service_leave' | 'other', required
        - `source_reference` string, nullable, required
        - `name` string, required
        - `unit` string, required
        - `current_balance` string, decimal, nullable, required
        - `accrued` string, decimal, required
        - `taken_or_paid` string, decimal, required
        - `paid_amount` string, decimal, required
      - `partial` boolean, required
      - `overlapping_periods` boolean, required
    - `calculation` EmployeeCalculationRead, required
      - `amounts` object, required
      - `raw_amounts` object, required
      - `base_weekly_wage` string, decimal, nullable, required
      - `total_weekly_wage` string, decimal, nullable, required
      - `total` string, decimal, nullable, required
      - `estimated_priority` string, decimal, nullable, required
      - `estimated_unsecured` string, decimal, nullable, required
      - `advisory_status` 'estimated' | 'review', required
      - `advisory_reason` string, required
      - `calculation_steps` EmployeeCalculationStep[], required
        - `category` string, required
        - `formula_text` string, required
        - `inputs` object, required
        - `result` union, required
          - string
          - integer
          - number
          - boolean
        - `unit` string, required
        - `statutory_ref` string, required
        - `note` string, nullable, required
      - `suggestions` object, required
      - `claim_amounts` object, required
      - `recorded_payments` string, decimal, required
      - `winding_up_costs` string, decimal, required
    - `status` 'Missing data' | 'Review' | 'Needs calculation' | 'Ready', required
    - `automatic_input_fields` string[], required
    - `weekly_allowances_unresolved` boolean, required
  - `totals` EntitlementTotals, required
    - `employee_count` integer, required
    - `total` string, decimal, nullable, required
    - `estimated_priority` string, decimal, nullable, required
    - `estimated_unsecured` string, decimal, nullable, required
  - `engine_version` string, required
  - `included_employee_count` integer, required
  - `snapshot_id` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/ender/apis/ender-backend.md) - [All operations](https://skmtc.dev/ender/apis/ender-backend/llms.txt) - [OpenAPI document](https://skmtc.dev/ender/apis/ender-backend/revisions/bf4373130521?raw)
