Members

Create an approved member qualifying life event

Creates an immediately approved qualifying life event. The caller must have write access to the target member, and API access tokens cannot create events. A member not visible to the caller returns a 404 before the body is validated. Describing the event is required when event_type is 'other'.

post/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_*)

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.

Request body

event_type'lost_job_based_coverage' | 'aged_off_parent_plan' | 'lost_medicaid_chip_medicare' | 'lost_decertified_individual_plan' | 'married' | 'divorced' | 'had_baby' | 'adopted_child' | 'foster_care_placement' | 'death_of_spouse_or_dependent' | 'court_ordered' | 'moved_to_new_coverage_area' | 'moved_to_us' | 'moved_to_or_from_school_housing' | 'moved_to_or_from_seasonal_work_housing' | 'became_us_citizen' | 'left_incarceration' | 'gained_tribal_status' | 'started_or_ended_americorps_service' | 'new_child' | 'other' required
  • lost_job_based_coverage - lost_job_based_coverage
  • aged_off_parent_plan - aged_off_parent_plan
  • lost_medicaid_chip_medicare - lost_medicaid_chip_medicare
  • lost_decertified_individual_plan - lost_decertified_individual_plan
  • married - married
  • divorced - divorced
  • had_baby - had_baby
  • adopted_child - adopted_child
  • foster_care_placement - foster_care_placement
  • death_of_spouse_or_dependent - death_of_spouse_or_dependent
  • court_ordered - court_ordered
  • moved_to_new_coverage_area - moved_to_new_coverage_area
  • moved_to_us - moved_to_us
  • moved_to_or_from_school_housing - moved_to_or_from_school_housing
  • moved_to_or_from_seasonal_work_housing - moved_to_or_from_seasonal_work_housing
  • became_us_citizen - became_us_citizen
  • left_incarceration - left_incarceration
  • gained_tribal_status - gained_tribal_status
  • started_or_ended_americorps_service - started_or_ended_americorps_service
  • new_child - new_child
  • other - other
other_eventstring nullable

Free-text description of the event; required when event_type is 'other'

Response

Changes

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