List member dependents

GET/v1/members/{member_id}/dependents

Lists a member’s active legal dependents — name, relationship, date of birth, age, and sex at birth. Access is scoped to the authenticated principal; a member not visible to the caller returns a 404.

Path ParametersExpand Collapse

member_id: string

Unique member identifier (mbr_*)

ReturnsExpand Collapse

data: array of { age, date_of_birth, first_name, 5 more }

age: number

Dependent’s age in years, derived from date of birth

date_of_birth: string

Date of birth (YYYY-MM-DD)

formatdate

first_name: string

Dependent’s first name

last_name: string

Dependent’s last name

member_id: string

The dependent’s own member identifier with ‘mbr_’ prefix

primary_member_id: string

The primary member’s identifier with ‘mbr_’ prefix

relationship: "Spouse" or "Child"

Spouse - Spouse
Child - Child

One of the following:

"Spouse"

"Child"

sex_at_birth: optional "Male" or "Female" or "Other" or "Unknown"

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

One of the following:

"Male"

"Female"

"Other"

"Unknown"

List member dependents

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

{
  "data": [
    {
      "name": "Sam Doe",
      "relationship": "Child",
      "date_of_birth": "2015-06-01",
      "age": 11,
      "sex_at_birth": "Male"
    }
  ]
}

Returns Examples

{
  "data": [
    {
      "name": "Sam Doe",
      "relationship": "Child",
      "date_of_birth": "2015-06-01",
      "age": 11,
      "sex_at_birth": "Male"
    }
  ]
}