DocumentationAPI Reference
API Reference

List Employee Dependents

get
https://{companyDomain}.bamboohr.com/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

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
integer

The internal employee ID to filter dependents by. When provided, only dependents for that employee are returned. When omitted, all company dependents are returned.

Headers
string
enum

This endpoint can produce either JSON or XML.

Allowed:
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

403

The authenticated user does not have Benefits Administration permissions.

Updated 3 months ago

Language
Credentials
:
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 3 months ago