> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://developer.vitablehealth.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developer.vitablehealth.com/_mcp/server. # List Enrollments GET https://api.vitablehealth.com/v1/members/{member_id}/enrollments Lists a member's benefit enrollments across every employer — benefit type and product, employer, carrier, plan, tier, employee deduction, employer contribution and total premium, the individual enrollment coverage boundary (`coverage_end`), the separate pre-effective cancellation boundary (`cancelled_date`), and the distinct benefit plan-year boundary (`plan_year_coverage_end`) used to determine whether the plan year itself has ended, the date the enrollment record was created (`issued_date`, the value Ops labels Issued on, reported for every row whatever the member answered), the window the member could answer in -- which never opens before the enrollment was issued, so a row issued mid-open-enrollment starts its window on its issue date -- whether a qualifying life event would currently be required for reissue under the product/open-enrollment rule, enrollment/open-enrollment window, and two statuses: `election_status` (what the member answered) and `policy_status` (what became of their coverage, null unless they enrolled). Every row includes a stable enrollment ID and the exact employer and benefit plan-year IDs used to fetch that row's plan-year detail. The full list is returned across all states so the client derives active plans (effective and upcoming) and the enrollment history from those per-row statuses. For an organization caller the rows are scoped to companies in that organization's book; a member (self/household) or Vitable Admin sees all enrollments. A member not visible to the caller returns a 404. Reference: https://developer.vitablehealth.com/api/members/list-enrollments ## Authentication - `Authorization` header (bearer token, required) — API Key or Access Token authentication using Bearer token in Authorization header. API keys use the vit_apk_ prefix, access tokens use the vit_at_ prefix. ## Servers - `https://api.vitablehealth.com` (Production, default) - `https://api.uat.vitablehealth.com` (UAT) ## Request ### Path parameters - `member_id` (string, required) — Unique member identifier (mbr_*) ### Headers - `X-Vitable-Organization` (string, optional) — 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 ### 200 - `data` (list of MemberEnrollment, required) — The member's benefit enrollments. ## Errors ### 400 Bad Request Error Bad Request - Invalid input or validation error - `timestamp` (datetime, required) — ISO 8601 timestamp when the error occurred - `message` (string, required) — Human-readable error message - `error` (string, required) — Error message (same as message, for backwards compatibility) - `trace_id` (string, required) — Unique trace ID for debugging and support requests - `app_error_code` (string, optional, nullable) — Application-specific error code for programmatic handling ### 401 Unauthorized Error Unauthorized - Invalid or missing API key - `timestamp` (datetime, required) — ISO 8601 timestamp when the error occurred - `message` (string, required) — Human-readable error message - `error` (string, required) — Error message (same as message, for backwards compatibility) - `trace_id` (string, required) — Unique trace ID for debugging and support requests - `app_error_code` (string, optional, nullable) — Application-specific error code for programmatic handling ### 403 Forbidden Error Forbidden - Insufficient permissions for this resource - `timestamp` (datetime, required) — ISO 8601 timestamp when the error occurred - `message` (string, required) — Human-readable error message - `error` (string, required) — Error message (same as message, for backwards compatibility) - `trace_id` (string, required) — Unique trace ID for debugging and support requests - `app_error_code` (string, optional, nullable) — Application-specific error code for programmatic handling ### 404 Not Found Error Resource not found. - `timestamp` (datetime, required) — ISO 8601 timestamp when the error occurred - `message` (string, required) — Human-readable error message - `error` (string, required) — Error message (same as message, for backwards compatibility) - `trace_id` (string, required) — Unique trace ID for debugging and support requests - `app_error_code` (string, optional, nullable) — Application-specific error code for programmatic handling ### 409 Conflict Error Conflict - Resource already exists or conflicts with current state - `timestamp` (datetime, required) — ISO 8601 timestamp when the error occurred - `message` (string, required) — Human-readable error message - `error` (string, required) — Error message (same as message, for backwards compatibility) - `trace_id` (string, required) — Unique trace ID for debugging and support requests - `app_error_code` (string, optional, nullable) — Application-specific error code for programmatic handling ### 429 Too Many Requests Error Too Many Requests - Rate limit exceeded - `timestamp` (datetime, required) — ISO 8601 timestamp when the error occurred - `message` (string, required) — Human-readable error message - `error` (string, required) — Error message (same as message, for backwards compatibility) - `trace_id` (string, required) — Unique trace ID for debugging and support requests - `app_error_code` (string, optional, nullable) — Application-specific error code for programmatic handling ### 500 Internal Server Error Internal Server Error - An unexpected error occurred - `timestamp` (datetime, required) — ISO 8601 timestamp when the error occurred - `message` (string, required) — Human-readable error message - `error` (string, required) — Error message (same as message, for backwards compatibility) - `trace_id` (string, required) — Unique trace ID for debugging and support requests - `app_error_code` (string, optional, nullable) — Application-specific error code for programmatic handling ### 502 Bad Gateway Error Bad Gateway - External service error - `timestamp` (datetime, required) — ISO 8601 timestamp when the error occurred - `message` (string, required) — Human-readable error message - `error` (string, required) — Error message (same as message, for backwards compatibility) - `trace_id` (string, required) — Unique trace ID for debugging and support requests - `app_error_code` (string, optional, nullable) — Application-specific error code for programmatic handling ## Types ### MemberEnrollment Wire serializer for :class:`MemberEnrollmentDTO` (one benefit enrollment row). - `id` (string, required) — Opaque, stable enrollment identifier used to target enrollment actions - `employer_id` (string, required) — Exact employer identifier for this enrollment - `benefit_plan_year_id` (string, required) — Exact benefit plan-year identifier for this enrollment - `benefit_type` (enum, required) — High-level benefit grouping (e.g., Medical, Dental) * `Medical` - Medical * `Dental` - Dental * `Vision` - Vision * `Hospital` - Hospital - Allowed values: `Medical`, `Dental`, `Vision`, `Hospital` - `product_code` (enum, required) — The benefit product this enrollment is for * `EBA` - Eba Mec * `VPC` - Vpc Enhanced * `VPC_CORE` - Vpc Core * `MEC` - Vpc Mec * `MEC2` - Mec2 * `MEC_PLUS` - Mec Plus * `MVP` - Mvp * `MVP2` - Mvp2 * `MVPSL` - Mvpsl * `MVPSL2` - Mvpsl2 * `VD` - Dental * `VV` - Vision * `ICHRA` - Ichra * `ICHRA_PREMIUM_PLUS` - Ichra Premium Plus * `ICHRA_REIMBURSEMENT_ONLY` - Ichra Reimbursement Only - Allowed values: `EBA`, `VPC`, `VPC_CORE`, `MEC`, `MEC2`, `MEC_PLUS`, `MVP`, `MVP2`, `MVPSL`, `MVPSL2`, `VD`, `VV`, `ICHRA`, `ICHRA_PREMIUM_PLUS`, `ICHRA_REIMBURSEMENT_ONLY` - `requires_qle_for_reissue` (boolean, required) — Whether a qualifying life event would be required to reissue this enrollment under the product and open-enrollment rule at the time this list was read - `product_name` (string, required) — Display name of the benefit product - `employer_name` (string, required) — Name of the employer the enrollment is through - `cancelled_date` (date, required, nullable) — Earliest applicable coverage boundary (YYYY-MM-DD) when coverage was cancelled before its effective start; null unless the enrollment was cancelled - `plan_year_coverage_end` (date, required, nullable) — Benefit plan-year coverage end date (YYYY-MM-DD), distinct from this enrollment's coverage_end; null when the plan year is open-ended - `issued_date` (date, required) — Date the enrollment record was created (YYYY-MM-DD), the value Ops labels Issued on. Present on every row whatever the member answered, and distinct from `coverage_start`. It equals `enrollment_window_start` for a row issued once its open enrollment had already opened, and precedes it for a row issued ahead of open enrollment. - `enrolled_date` (date, required, nullable) — Date the member enrolled (YYYY-MM-DD); null unless the row is an election - `answered_at` (datetime, required, nullable) — When the employee enrolled or waived - `enrollment_window_start` (date, required) — First date the member could answer this enrollment (YYYY-MM-DD). Open enrollment's start date for a row issued before open enrollment opened, otherwise the date the row was issued -- an enrollment is never answerable before it exists, so this is never earlier than `issued_date`. - `election_status` (enum, required) — Where the member stands: `Enrolled` or `Waived` if they answered, otherwise `Pending` while their enrollment window is open and `Expired` once it has closed. * `Enrolled` - Enrolled * `Waived` - Waived * `Pending` - Pending * `Expired` - Expired - Allowed values: `Enrolled`, `Waived`, `Pending`, `Expired` - `policy_status` (enum, required, nullable) — Where the member's coverage stands: `Coverage Upcoming`, `Coverage Effective`, `Coverage Ended`, or `Cancelled`. Null unless the member enrolled. * `Coverage Upcoming` - Coverage Upcoming * `Coverage Effective` - Coverage Effective * `Coverage Ended` - Coverage Ended * `Cancelled` - Cancelled - Allowed values: `Coverage Upcoming`, `Coverage Effective`, `Coverage Ended`, `Cancelled` - `plan_year_ends_this_month` (boolean, required) — True when today (ET) falls in the final month of the plan year. No new enrollment can start in that month, so it drives Reissue availability on the client. - `is_within_enrollment_window` (boolean, required) — True when today falls inside the enrollment window this member has to answer in; drives enrollment-action availability on the client. - `plan_year_ichra_affordability` (enum, required, nullable) — Whether this ICHRA plan year was marked `Affordable` or `Not Affordable` when it was configured. A plan-year setting, not a calculation for this member. Null for non-ICHRA rows and for ICHRA plan years where it has not been set. * `Affordable` - Affordable * `Not Affordable` - Not Affordable - Allowed values: `Affordable`, `Not Affordable` - `carrier_name` (string, optional, nullable) — Insurance carrier name; null when no active carrier period is resolvable - `plan_name` (string, optional, nullable) — Chosen benefit plan name; null unless the row is an election - `tier_name` (string, optional, nullable) — Chosen benefit plan tier name (e.g., Employee Only); null unless the row is an election - `employee_deduction_in_cents` (integer, optional, nullable) — Employee monthly payroll deduction in cents; null unless the row is an election - `employer_contribution_in_cents` (integer, optional, nullable) — Employer monthly contribution in cents; null unless the row is an election - `premium_in_cents` (integer, optional, nullable) — Total monthly plan premium in cents; null unless the row is an election - `coverage_start` (date, optional, nullable) — Coverage window start date (YYYY-MM-DD) - `coverage_end` (date, optional, nullable) — Coverage window end date (YYYY-MM-DD); null while coverage is open-ended - `enrollment_window_end` (date, optional, nullable) — Enrollment / open-enrollment window end date (YYYY-MM-DD); null when open-ended ## Examples **Response** ```json { "data": [ { "id": "enrl_AAAAAAAAAAAAAAAAAAAAAQ", "employer_id": "empr_AAAAAAAAAAAAAAAAAAAAAQ", "benefit_plan_year_id": "plyr_AAAAAAAAAAAAAAAAAAAAAQ", "benefit_type": "Medical", "product_code": "MEC_PLUS", "requires_qle_for_reissue": false, "product_name": "MEC Plus", "employer_name": "Acme Corp", "cancelled_date": null, "plan_year_coverage_end": "2026-12-31", "issued_date": "2026-03-04", "enrolled_date": "2026-03-10", "answered_at": "2024-01-15T09:30:00Z", "enrollment_window_start": "2026-03-04", "election_status": "Enrolled", "policy_status": "Coverage Effective", "plan_year_ends_this_month": true, "is_within_enrollment_window": false, "plan_year_ichra_affordability": null, "carrier_name": "Vitable", "plan_name": "MEC Plus Standard", "tier_name": "Employee Only", "employee_deduction_in_cents": 5000, "employer_contribution_in_cents": 25000, "premium_in_cents": 30000, "coverage_start": "2026-04-01", "coverage_end": "2026-08-31", "enrollment_window_end": "2026-03-31" }, { "id": "enrl_AAAAAAAAAAAAAAAAAAAAAg", "employer_id": "empr_AAAAAAAAAAAAAAAAAAAAAg", "benefit_plan_year_id": "plyr_AAAAAAAAAAAAAAAAAAAAAg", "benefit_type": "Dental", "product_code": "VD", "requires_qle_for_reissue": true, "product_name": "Vitable Dental", "employer_name": "Acme Corp", "cancelled_date": null, "plan_year_coverage_end": "2026-12-31", "issued_date": "2026-03-04", "enrolled_date": null, "answered_at": "2024-01-15T09:30:00Z", "enrollment_window_start": "2026-03-04", "election_status": "Waived", "policy_status": null, "plan_year_ends_this_month": false, "is_within_enrollment_window": false, "plan_year_ichra_affordability": null, "carrier_name": "Vitable", "plan_name": null, "tier_name": null, "employee_deduction_in_cents": null, "employer_contribution_in_cents": null, "premium_in_cents": null, "coverage_start": null, "coverage_end": null, "enrollment_window_end": "2026-03-31" }, { "id": "enrl_AAAAAAAAAAAAAAAAAAAAAw", "employer_id": "empr_AAAAAAAAAAAAAAAAAAAAAw", "benefit_plan_year_id": "plyr_AAAAAAAAAAAAAAAAAAAAAw", "benefit_type": "Dental", "product_code": "VD", "requires_qle_for_reissue": true, "product_name": "Vitable Dental", "employer_name": "Acme Corp", "cancelled_date": "2026-03-15", "plan_year_coverage_end": "2026-12-31", "issued_date": "2026-03-04", "enrolled_date": "2026-03-10", "answered_at": "2024-01-15T09:30:00Z", "enrollment_window_start": "2026-03-04", "election_status": "Enrolled", "policy_status": "Cancelled", "plan_year_ends_this_month": false, "is_within_enrollment_window": false, "plan_year_ichra_affordability": null, "carrier_name": "Vitable", "plan_name": "Vitable Dental Standard", "tier_name": "Employee Only", "employee_deduction_in_cents": 1200, "employer_contribution_in_cents": 800, "premium_in_cents": 2000, "coverage_start": null, "coverage_end": null, "enrollment_window_end": "2026-03-31" } ] } ``` **SDK Code** ```python Member Enrollments import requests url = "https://api.vitablehealth.com/v1/members/mbr_abc123def456/enrollments" headers = {"Authorization": "Bearer "} response = requests.get(url, headers=headers) print(response.json()) ``` ```javascript Member Enrollments const url = 'https://api.vitablehealth.com/v1/members/mbr_abc123def456/enrollments'; const options = {method: 'GET', headers: {Authorization: 'Bearer '}}; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Member Enrollments package main import ( "fmt" "net/http" "io" ) func main() { url := "https://api.vitablehealth.com/v1/members/mbr_abc123def456/enrollments" req, _ := http.NewRequest("GET", url, nil) req.Header.Add("Authorization", "Bearer ") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Member Enrollments require 'uri' require 'net/http' url = URI("https://api.vitablehealth.com/v1/members/mbr_abc123def456/enrollments") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Get.new(url) request["Authorization"] = 'Bearer ' response = http.request(request) puts response.read_body ``` ```java Member Enrollments import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.get("https://api.vitablehealth.com/v1/members/mbr_abc123def456/enrollments") .header("Authorization", "Bearer ") .asString(); ``` ```php Member Enrollments request('GET', 'https://api.vitablehealth.com/v1/members/mbr_abc123def456/enrollments', [ 'headers' => [ 'Authorization' => 'Bearer ', ], ]); echo $response->getBody(); ``` ```csharp Member Enrollments using RestSharp; var client = new RestClient("https://api.vitablehealth.com/v1/members/mbr_abc123def456/enrollments"); var request = new RestRequest(Method.GET); request.AddHeader("Authorization", "Bearer "); IRestResponse response = client.Execute(request); ``` ```swift Member Enrollments import Foundation let headers = ["Authorization": "Bearer "] let request = NSMutableURLRequest(url: NSURL(string: "https://api.vitablehealth.com/v1/members/mbr_abc123def456/enrollments")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "GET" request.allHTTPHeaderFields = headers let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```