Skip to content
Vitable Docs Vitable Docs Vitable Docs
API Reference
Enrollments

Terminate an enrollment

POST/v1/enrollments/{enrollment_id}/terminate

Terminates enrolled coverage immediately. An accepted qualifying life event owned by the enrollment member is required unless the plan is VPC or ICHRA. User-backed callers must provide a reason; it is optional for userless organization callers. API keys may act across the caller organization’s book. Tenant mismatches return the same non-disclosing 404 before the request body is validated.

Path ParametersExpand Collapse
enrollment_id: string

Unique enrollment identifier (enrl_*)

Body ParametersJSONExpand Collapse
qualifying_life_event_id: optional string

Accepted member qualifying life event identifier (qle_*)

reason: optional string

Audit reason for the termination; required for user-backed callers and optional for userless organization callers

ticket_number: optional string

Optional support or operational ticket number

maxLength1000

Terminate an enrollment

curl https://api.vitablehealth.com/v1/enrollments/$ENROLLMENT_ID/terminate \
    -X POST \
    -H "Authorization: Bearer $VITABLE_CONNECT_API_KEY"
Returns Examples