---
title: "List Member Benefits"
method: GET
path: "/api/v1/benefits/member-benefits"
tags: ["Benefits", "Public API"]
---

# List Member Benefits

`GET /api/v1/benefits/member-benefits`

Returns a paginated list of benefit enrollment records for all members (employees and dependents) in the company for a given calendar year. Each record represents one member and includes the plans they held and the date ranges during which they held each enrollment status. Dependents appear alongside their subscribing employee via subscriberId. Use "List Company Benefits" to get valid planId values.

OAuth Scopes: benefit

## Query parameters

- `calendarYear` string, required
- `page` string
- `pageSize` string

## Response `200`

A paginated list of member benefit enrollment records for the requested calendar year.

- object
  - `data` object[]
    - `memberId` string — The member identifier. Formatted as "employee.{id}" for employees and "dependent.{id}" for dependents.
    - `subscriberId` string — The employee ID of the plan subscriber as a string. For dependent members, this is the ID of the employee they are enrolled under.
    - `plans` object[]
      - `planId` string — The benefit plan ID.
      - `dateRanges` object[]
        - `startDate` string, date — Start date of the enrollment period (YYYY-MM-DD).
        - `endDate` string, date, nullable — End date of the enrollment period (YYYY-MM-DD), or null if the enrollment has no calculated end date.
        - `status` 'ENROLLED' | 'WAIVED' | 'TERMINATED' | 'WITHDREW' | 'ELIGIBLE' | 'INELIGIBLE' — The enrollment status for this date range.
  - `meta` object
    - `page` integer — The current page number.
    - `pageSize` integer — The number of items per page.
    - `totalPages` integer — Total number of pages available.
    - `totalItems` integer — Total number of member records across all pages.
  - `_links` object
    - `next` object
      - `href` string — URL for the next page of results. Points to the current page when already on the last page.
    - `prev` object
      - `href` string — URL for the previous page of results. Points to page 1 when already on the first page.

## Other responses

- `400` — Validation error. Returned when calendarYear is missing or not a 4-digit year, or when page or pageSize are out of range.
- `403` — Permission denied. The authenticated user is not a benefit admin.

---

[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/revisions/19ebf391a399/schema)