The Membership endpoints enable ICHRA vendors to manage the full enrollment lifecycle for their members. Through these endpoints, vendors can create new membership for members and their dependents, retrieve current coverage and eligibility details including enrollment status and payment state, and update existing membership to modify member information, add dependents, or change policy and broker details. This is the primary interface for vendors to onboard members onto Oscar plans and confirm their enrollment status after submitting an application.

Get Membership

The Memberships endpoint allows ICHRA vendors to retrieve a member's current coverage and eligibility details. This functionality is read-only and is used to check whether a member is enrolled, their coverage status, member demographic details, and their payment/effectuation state. This is the primary way for vendors to confirm a member's enrollment status with Oscar after submitting an application.

When to Use

• Enrollment confirmation: After submitting an application, vendors can use the Memberships API to confirm that the member has an active coverage span.
• Eligibility checks: Vendors can verify whether a member is currently effectuated, terminated, or cancelled.
• Dependent coverage: When querying for any member of a family, the API will return the full family unit and their respective coverage spans.
• Payment status: Vendors can check whether a member's coverage is paid, unpaid, or in grace period.

Endpoint

POST /ichra-api/v1/memberships/get-membership

See the Membership API Reference for full details.

Create Membership

The Create Membership endpoint allows ICHRA vendors to enroll a new member and their dependents. This is used when onboarding members who do not yet have an existing Oscar contract. All enrollees in the request are treated as additions. A policy holder must be included in the enrollees list.

When to Use

• New enrollments: Onboard members who do not yet have an existing Oscar contract.
• Family enrollment: Enroll a policy holder along with their dependents in a single request.

Endpoint

POST /ichra-api/v1/memberships/create-membership

See the Create Membership API Reference for full details.

Update Membership

The Update Membership endpoint allows ICHRA vendors to modify an existing member's enrollment, including updating enrollee details, adding new dependents, or changing policy information.

When to Use

• Update member details: Modify existing enrollee information such as address, name, or coverage dates.
• Add dependents: Add new dependents to an existing contract.
• Policy changes: Update policy information or broker details for an existing enrollment.

Endpoint

POST /ichra-api/v1/memberships/update-membership

See the Update Membership API Reference for full details.