# List employees

Endpoint: GET /employees
Version: 2.0.0
Security: oauth2ClientCredentials

## Query parameters:

  - `page` (number)
    Page number (minimum: 1)

  - `limit` (number)
    Number of items per page (minimum: 1, maximum: 1000)

  - `team_id` (string)
    Filter by team ID

  - `status` (string)
    Filter by employee status (e.g., ACTIVE, INACTIVE)

## Header parameters:

  - `org_wallet_ref` (string)
    Organization wallet reference, defaults to "1" if not provided

  - `business_id` (string, required)
    Business identifier for the request

## Response 200 fields (application/json):

  - `docs` (array)
    Employee documents

  - `total` (number)
    Total count

  - `limit` (object)
    Limit per page

  - `page` (object)
    Current page

  - `pages` (number)
    Total pages