---
title: "List Company Benefits"
method: GET
path: "/api/v1/benefit/company_benefit"
tags: ["Benefits", "Public API"]
---

# List Company Benefits

`GET /api/v1/benefit/company_benefit`

Returns all active (non-deleted) company benefit plans for the account. Each plan includes summary-level fields such as name, benefit category type, associated vendor and deduction IDs, effective date range, and catch-up eligibility flags. Deleted plans are excluded. To retrieve full detail for a specific plan (including SSO URL, description, and ACA fields), use "Get a company benefit".

OAuth Scopes: benefit

## Response `200`

An object containing a companyBenefits array of benefit plan summaries.

- object
  - `companyBenefits` CompanyBenefitSummary[] — List of company benefit plan summaries.
    - `id` string — The unique identifier of the company benefit plan.
    - `name` string — The name of the company benefit plan.
    - `type` 'health' | 'dental' | 'vision' | 'retirement' | 'hsa' | 'flex' | 'life' | 'disability' | 'reimbursement' | 'supplemental' | 'other' — The benefit category type.
    - `benefitVendorId` string, nullable — The ID of the benefit vendor associated with this plan, or null if none.
    - `deductionTypeId` string, nullable — The deduction type ID for this plan, or null if not applicable.
    - `companyDeductionId` string, nullable — The company-level deduction record ID linked to this plan, or null if not set.
    - `startDate` string, date, nullable — The date the benefit plan becomes effective (YYYY-MM-DD), or null if not set.
    - `endDate` string, date, nullable — The date the benefit plan ends (YYYY-MM-DD), or null if ongoing.
    - `allowsCatchUp` boolean, nullable — Whether the plan allows catch-up contributions (e.g., for HSA plans for employees 55+), or null if not applicable to this plan type.
    - `allowsSuperCatchUp` boolean, nullable — Whether the plan allows super catch-up contributions, or null if not applicable to this plan type.

## Other responses

- `401` — Unauthorized. Invalid or missing authentication credentials.
- `500` — Internal server error.

---

[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)