---
title: "List Member Benefit Events"
method: GET
path: "/api/v1/benefit/member_benefit"
tags: ["Benefits", "Public API"]
---

# List Member Benefit Events

`GET /api/v1/benefit/member_benefit`

Returns benefit enrollment events for all employees and their dependents over the past year, organized by member. Each entry identifies a member (employee or dependent) and lists their per-plan coverage events (eligibility granted, enrolled, or loss of coverage), sorted chronologically. Requires benefit settings access.

OAuth Scopes: benefit

## Response `200`

An object containing a members array of member benefit event records.

- object
  - `members` MemberBenefitEvent[] — List of member benefit event records, one entry per employee or dependent.
    - `memberId` string — The unique identifier of the member. Format: 'employee.{id}' for employees, 'dependent.{id}' for dependents.
    - `coverages` object[] — The benefit plan coverages for this member, one entry per plan.
      - `planId` string — The ID of the benefit plan.
      - `events` object[] — Chronological list of benefit events for this member and plan, covering the past year. Event type 'enrollment' includes premiumTierId and monthlyPremiumInCents; 'eligibility' and 'loss' events include only effectiveDate and type.
        - `effectiveDate` string, date — The date this event takes effect (YYYY-MM-DD).
        - `type` 'eligibility' | 'enrollment' | 'loss' — The type of benefit event.
        - `premiumTierId` string, nullable — The premium tier ID for enrollment events. Only present on events with type 'enrollment'.
        - `monthlyPremiumInCents` number, nullable — The monthly premium amount in cents for enrollment events. Only present on events with type 'enrollment'.

## Other responses

- `401` — Unauthorized. Invalid or missing authentication credentials.
- `403` — Forbidden. The authenticated user does not have benefit settings access.

---

[API](https://skmtc.net/bamboohr/apis/bamboohr-api.md) · [All operations](https://skmtc.net/bamboohr/apis/bamboohr-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bamboohr/bamboohr-api/versions/19ebf391a399/schema)