---
title: "Get Employee Dependent"
method: GET
path: "/api/v1/employeedependents/{id}"
tags: ["Benefits", "Public API"]
---

# Get Employee Dependent

`GET /api/v1/employeedependents/{id}`

Returns the details of a single employee dependent by their dependent ID. The response is a JSON object with a top-level key "Employee Dependents" containing a single-element array. SSN and SIN are returned as masked values (e.g. "xxx-xx-1234"). State and country are returned as full names. Supports both JSON and XML response formats via the Accept header. Requires Benefits Administration permissions.

OAuth Scopes: employee:dependent, employee:dependent:ssn

## Path parameters

- `id` integer, required

## Headers

- `AcceptHeaderParameter` 'application/xml' | 'application/json'

## Response `200`

The requested employee dependent.

- EmployeeDependentsResponse
  - `Employee Dependents` object[] — Array of employee dependent objects.
    - `id` string — The unique ID of the dependent record.
    - `employeeId` string — The internal employee ID of the employee this dependent belongs to.
    - `firstName` string — The dependent's first name.
    - `middleName` string, nullable — The dependent's middle name. Null if not set.
    - `lastName` string — The dependent's last name.
    - `relationship` string — The dependent's relationship to the employee.
    - `gender` string — The dependent's gender.
    - `maskedSSN` string, nullable — The dependent's masked SSN (e.g. "xxx-xx-1234"). Null if no SSN on file.
    - `maskedSIN` string, nullable — The dependent's masked SIN. Null if no SIN on file.
    - `dateOfBirth` string, date — The dependent's date of birth in YYYY-MM-DD format.
    - `addressLine1` string, nullable — The first line of the dependent's address. Null if not set.
    - `addressLine2` string, nullable — The second line of the dependent's address. Null if not set.
    - `city` string, nullable — The dependent's city. Null if not set.
    - `state` string, nullable — The dependent's state as a full name (e.g. "Utah"). Null if not set.
    - `zipCode` string, nullable — The dependent's ZIP or postal code. Null if not set.
    - `homePhone` string, nullable — The dependent's home phone number. Null if not set.
    - `country` string, nullable — The dependent's country as a full name (e.g. "United States"). Null if not set.
    - `isUsCitizen` 'yes' | 'no', nullable — Whether the dependent is a US citizen. "yes" or "no". Null if not set.
    - `isStudent` 'yes' | 'no', nullable — Whether the dependent is currently a student. "yes" or "no". Null if not set.

## Other responses

- `400` — The specified dependent ID was not found.
- `403` — The authenticated user does not have Benefits Administration permissions.

---

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