---
title: "List Employees"
method: GET
path: "/v1/employees"
tags: ["Employees"]
---

# List Employees

`GET /v1/employees`

List all employees for a given employer with pagination.

## Query parameters

- `employerId` string, required
- `limit` string
- `offset` string
- `search` string
- `activeAccount` 'Active' | 'Inactive'

## Response `200`

Employees retrieved successfully

- object — Employees retrieved successfully
  - `success` boolean, required
  - `employees` object[], required — List of employees
    - `_id` string, required — Unique identifier
    - `firstName` string, required — First name
    - `lastName` string, required — Last name
    - `email` string, required — Email address
    - `dob` string — Date of birth
    - `title` string — Job title
    - `activeAccount` 'Active' | 'Inactive' — Account status
    - `blurb` string — Brief description or bio
    - `address` object — Employee address
      - `street1` string, required — Street address line 1
      - `street2` string — Street address line 2
      - `city` string, required — City
      - `state` string, required — State
      - `postalCode` string, required — Postal code
      - `county` string — County
      - `country` string — Country
    - `phone` object[] — Contact phone numbers
      - `number` string, required — Phone number
      - `type` 'Cell' | 'Home' | 'Work' | 'Other', required — Type of phone number
    - `employer_id` string, required — ID of associated employer
    - `departments` string[] — List of department names
    - `extendedFields` object[] — Additional custom fields
      - `name` string, required — Field name
      - `value` string, required — Field value
    - `createdAt` string, date-time — Creation timestamp
    - `createdBy` string — ID of user who created the employee
    - `updatedAt` string, date-time — Last update timestamp
    - `updatedBy` string — ID of user who last updated the employee
  - `total` number, required — Total number of employees returned
  - `message` string, required

## Other responses

- `400` — Validation error
- `401` — Authentication error
- `404` — Employer not found
- `500` — Server error

---

[API](https://skmtc.net/bluehive-health/apis/bluehive-api.md) · [All operations](https://skmtc.net/bluehive-health/apis/bluehive-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bluehive-health/bluehive-api/revisions/e6e553c2594a/schema)