List member qualifying life events

GET/v1/members/{member_id}/qualifying-life-events

Lists a member’s qualifying life events, including events already used for another enrollment. Returns all statuses by default; pass the status query param to filter to one (e.g. approved). Events are ordered newest submission first with stable paging. Custom text is present only when submitted and is otherwise null. A member not visible to the caller returns a 404. API keys and unbound access tokens have organization-wide access. Employer-bound tokens require employment at the bound employer, and employee-bound tokens require the exact employee-member relationship. Organization or scope mismatches return a 404 before pagination is validated.

Path ParametersExpand Collapse

member_id: string

Unique member identifier (mbr_*)

Query ParametersExpand Collapse

limit: optional number

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

minimum1

maximum100

page: optional number

Page number (default: 1)

minimum1

status: optional "approved" or "denied" or "pending"

Optional. Filter to a single QLE status; omit to return all statuses.

One of the following:

"approved"

"denied"

"pending"

ReturnsExpand Collapse

data: array of { id, event_type, other_event, 2 more }

id: string

Opaque qualifying life event identifier

event_type: "Married" or "Divorced" or "New child" or 2 more

Married - Married
Divorced - Divorced
New child - New Child
Court ordered - Court Ordered
Other - Other

One of the following:

"Married"

"Divorced"

"New child"

"Court ordered"

"Other"

other_event: string

Custom event description when event_type is Other; otherwise normally null

status: "pending" or "approved" or "denied"

pending - Pending
approved - Approved
denied - Denied

One of the following:

"pending"

"approved"

"denied"

submitted_at: string

When the member submitted the event

formatdate-time

pagination: Pagination { limit, page, total, total_pages }

Pagination metadata for list responses.

limit: number

Items per page

page: number

Current page number

total: number

Total number of items

total_pages: number

Total number of pages

List member qualifying life events

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

{
  "data": [
    {
      "id": "qle_AAAAAAAAAAAAAAAAAAAAAQ",
      "event_type": "Other",
      "other_event": "Relocation",
      "status": "approved",
      "submitted_at": "2026-07-01T14:30:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 1,
    "total_pages": 1
  }
}

Returns Examples

{
  "data": [
    {
      "id": "qle_AAAAAAAAAAAAAAAAAAAAAQ",
      "event_type": "Other",
      "other_event": "Relocation",
      "status": "approved",
      "submitted_at": "2026-07-01T14:30:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 1,
    "total_pages": 1
  }
}