---
title: "List Benefit Coverages"
method: GET
path: "/api/v1/benefitcoverages"
tags: ["Benefits", "Public API"]
---

# List Benefit Coverages

`GET /api/v1/benefitcoverages`

Returns all benefit coverage levels configured in the company, such as Employee Only, Employee + Spouse, and Employee + Family. The JSON response wraps results under a "Benefit Coverages" key. Each coverage level includes an ID, short name, optional description, sort order, and an associated benefit plan ID (null for company-wide levels). Requires Benefits Administration permissions or owner/admin access.

OAuth Scopes: benefit

## Headers

- `AcceptHeaderParameter` 'application/xml' | 'application/json'

## Response `200`

A collection of benefit coverage levels ordered by sort order.

- object
  - `Benefit Coverages` object[] — Array of benefit coverage level objects.
    - `id` string — The coverage level ID.
    - `shortName` string — The short display name for this coverage level (e.g. "Employee + Spouse").
    - `description` string, nullable — An optional longer description of the coverage level. Null if not set.
    - `sortOrder` string — The display sort order for this coverage level.
    - `benefitPlanId` string, nullable — The benefit plan this coverage level belongs to, or null for company-wide coverage levels.

## Other responses

- `403` — The authenticated user does not have Benefits Administration permissions.

---

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