List member dependents

get/v1/members/{member_id}/dependents

Retrieves a paginated list of dependents for a specific member. Dependents include spouses, children, and domestic partners who may be eligible for benefit coverage.

Path ParametersExpand Collapse

member_id: string

Query ParametersExpand Collapse

active_in: optional boolean

Filter by active status

limit: optional number

Items per page (default: 20, max: 100)

minimum1

maximum100

page: optional number

Page number (default: 1)

minimum1

relationship: optional Relationship

Filter by relationship type

Accepts one of the following:

"Spouse"

"Child"

ReturnsExpand Collapse

id: string

Unique dependent identifier with 'dpnd_' prefix

active: boolean

Whether the dependent is currently active

created_at: string

Timestamp when the dependent was created

formatdate-time

date_of_birth: string

Dependent's date of birth (YYYY-MM-DD)

formatdate

first_name: string

Dependent's legal first name

last_name: string

Dependent's legal last name

member_id: string

ID of the primary member/employee (mbr_*)

relationship: Relationship

Spouse - Spouse
Child - Child

Accepts one of the following:

"Spouse"

"Child"

sex: Sex

Male - Male
Female - Female
Other - Other
Unknown - Unknown

Accepts one of the following:

"Male"

"Female"

"Other"

"Unknown"

updated_at: string

Timestamp when the dependent was last updated

formatdate-time

gender: optional string

Gender identity, if provided

ssn_last_four: optional string

Last 4 digits of SSN (masked)

suffix: optional string

Name suffix (e.g., Jr., Sr., III)

List member dependents

curl https://api.vitablehealth.com/v1/members/$MEMBER_ID/dependents \
    -H "Authorization: Bearer $VITABLE_connect_API_API_KEY"

[
  {
    "id": "id",
    "active": true,
    "created_at": "2019-12-27T18:11:19.117Z",
    "date_of_birth": "2019-12-27",
    "first_name": "first_name",
    "last_name": "last_name",
    "member_id": "member_id",
    "relationship": "Spouse",
    "sex": "Male",
    "updated_at": "2019-12-27T18:11:19.117Z",
    "gender": "gender",
    "ssn_last_four": "ssn_last_four",
    "suffix": "suffix"
  }
]

Returns Examples

[
  {
    "id": "id",
    "active": true,
    "created_at": "2019-12-27T18:11:19.117Z",
    "date_of_birth": "2019-12-27",
    "first_name": "first_name",
    "last_name": "last_name",
    "member_id": "member_id",
    "relationship": "Spouse",
    "sex": "Male",
    "updated_at": "2019-12-27T18:11:19.117Z",
    "gender": "gender",
    "ssn_last_four": "ssn_last_four",
    "suffix": "suffix"
  }
]