---
title: "List Employee Dependents"
method: GET
path: "/api/v1/employeedependents"
tags: ["Benefits", "Public API"]
---

# List Employee Dependents

`GET /api/v1/employeedependents`

Returns employee dependents for the company. When `employeeid` is provided, only dependents for that employee are returned. When omitted, all dependents across all employees are returned. The response is a JSON object with a top-level key "Employee Dependents" containing an array of dependent objects. 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

## Query parameters

- `employeeid` integer

## Headers

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

## Response `200`

A collection of employee dependents.

- 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

- `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)