---
title: "Benefit Aggregations"
method: GET
path: "/companies/{company}/benefit_aggregations"
---

# Benefit Aggregations

`GET /companies/{company}/benefit_aggregations`

## Request

- Base URL: `https://sandbox.checkhq.com`
- URL: `https://sandbox.checkhq.com/companies/{company}/benefit_aggregations`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/checkhq/apis/check-api/docs/companies/:company/benefit_aggregations/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a list of benefit aggregations for the company

## Path parameters

- `company` string, required

## Query parameters

- `start` string, date
- `end` string, date
- `expand_benefits` boolean

## Response `200`

200

- object
  - `next` unknown
  - `previous` unknown
  - `results` object[]
    - `benefit` object
      - `source` unknown
      - `period` unknown
      - `company_period_amount` unknown
      - `employee_period_amount` unknown
      - `id` string
      - `employee` string
      - `benefit` string
      - `company_benefit` unknown
      - `description` string
      - `effective_start` string
      - `effective_end` unknown
      - `company_contribution_amount` string
      - `company_contribution_percent` unknown
      - `employee_contribution_amount` string
      - `employee_contribution_percent` unknown
      - `hsa_contribution_limit` unknown
      - `metadata` object
    - `company_contribution_amount_to_date` string
    - `employee_contribution_amount_to_date` string

## Other responses

- `400`: 400

## Changes

- **2026-11-03** `5a54f5eb888b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/checkhq/apis/check-api/changes/companies/:company/benefit_aggregations/get.md)

---

[API](https://skmtc.dev/checkhq/apis/check-api.md) - [All operations](https://skmtc.dev/checkhq/apis/check-api/llms.txt) - [OpenAPI document](https://skmtc.dev/checkhq/apis/check-api/revisions/5a54f5eb888b?raw)