Members

List member 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.

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

Request

  • Base URL: https://api.vitablehealth.com
  • URL: https://api.vitablehealth.com/v1/members/{member_id}/qualifying-life-events
  • Auth: HTTP bearer

Path parameters

member_idstring required

Unique member identifier (mbr_*)

Query parameters

limitinteger

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

pageinteger

Page number (default: 1)

status'approved' | 'denied' | 'pending'

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

Headers

X-Vitable-Organizationstring

Organization to act as for this request (e.g. org_SGVsbG8gV29ybGQ). Optional when your credentials reach a single organization. Required when they reach several — omitting it then returns 400 organization_required. A malformed value returns 400 invalid_organization_header, and naming an organization you do not have access to returns 403 organization_access_denied.

Response

Changes

No recorded changes to this operation across all 1 revision of this API.