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

# Get Employee

`GET /v1/employees/{employeeId}`

## Request

- Base URL: `https://api.bluehive.com`
- URL: `https://api.bluehive.com/v1/employees/{employeeId}`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/bluehive-health/apis/bluehive-api/docs/v1/employees/:employeeId/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve an employee by their unique ID.

## Path parameters

- `employeeId` string, required

## Response `200`

Employee found successfully

- object: Employee found successfully
  - `success` boolean, required
  - `employee` object, required: Employee details
    - `_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
  - `message` string, required

## Other responses

- `401`: Authentication error
- `404`: Employee not found
- `500`: Server error

## Changes

- **2025-10-03** `2e0dd34abf24`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bluehive-health/apis/bluehive-api/changes/v1/employees/:employeeId/get.md)

---

[API](https://skmtc.dev/bluehive-health/apis/bluehive-api.md) - [All operations](https://skmtc.dev/bluehive-health/apis/bluehive-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bluehive-health/apis/bluehive-api/revisions/a8bcbdf02e33?raw)