# List employees

Endpoint: GET /payroll/employees
Version: 2.0.0
Security: OAuth2, OAuth2Sandbox

## Query parameters:

  - `filter[employment_status]` (string)
    Filter employees by employment status.

  - `include` (string)
    Comma-separated list of related resources to include in the response. Supported values: `active_employment.employment_group`.

## Response 200 fields (application/json):

  - `data` (array)

  - `data.id` (integer)
    Identifier of the employee in Fennoa.
    Example: 123

  - `data.person_number` (string)
    User modifiable employee identifier in Fennoa.
    Example: P1005

  - `data.first_name` (string)
    Example: Veera

  - `data.last_name` (string)
    Example: Virtanen

  - `data.identity_number` (string | null)
    Example: 010101-900P

  - `data.active_employment` (object | null)
    The employee's current active employment. Only included when requested via the `include=active_employment` query parameter. Null if the employee has no active employment.

  - `data.active_employment.id` (integer)
    Identifier of the employment.
    Example: 789

  - `data.active_employment.employment_group` (object)

  - `data.active_employment.employment_group.id` (integer)
    Example: 2

  - `data.active_employment.employment_group.name` (string)
    Example: Tuntipalkat

  - `meta` (object)

  - `meta.next_cursor` (string | null)
    Base64-encoded cursor for the next page, or null when there is no next page.
    Example: eyJpZCI6MX0=