---
title: "Get company benefit summary by company benefit id."
method: GET
path: "/v1/company_benefits/{company_benefit_id}/summary"
tags: ["Company Benefits"]
---

# Get company benefit summary by company benefit id.

`GET /v1/company_benefits/{company_benefit_id}/summary`

## Request

- Base URL: `https://api.gusto-demo.com`
- URL: `https://api.gusto-demo.com/v1/company_benefits/{company_benefit_id}/summary`
- Auth: HTTP bearer

Returns summary benefit data for the requested company benefit id.

Benefits containing PHI are only visible to applications with the `company_benefits:read:phi` scope.

scope: `company_benefits:read`

## Path parameters

- `company_benefit_id` string, required

## Query parameters

- `start_date` string
- `end_date` string
- `detailed` boolean

## Headers

- `X-Gusto-API-Version` '2026-06-15'

## Response `200`

Benefit summary response

- BenefitSummary
  - `start_date` string: The start date of benefit summary.
  - `end_date` string: The end date of benefit summary.
  - `description` string: Description of the benefit.
  - `company_benefit_deduction` string: The aggregate of employee deduction for all employees given the period of time and the specific company benefit.
  - `company_benefit_contribution` string: The aggregate of company contribution for all employees given the period of time and the specific company benefit.
  - `employees` object[]
    - `uuid` string: The UUID of the employee
    - `company_benefit_deduction` string: The sum of employee deduction for this employee given the period of time and the specific company benefit.
    - `company_benefit_contribution` string: The sum of company contribution for this employee given the period of time and the specific company benefit.
    - `benefit_deduction` string: The sum of employee benefit deduction for this employee given the period of time and the benefit type.
    - `benefit_contribution` string: The sum of company contribution for this employee given the period of time and the benefit type.
    - `gross_pay` string: Gross pay for this employee given the period of time.
    - `imputed_pay` string: Total imputed pay for this employee given the period of time (not scoped to a benefit type).
    - `payroll_benefits` object[]
      - `payroll_uuid` string
      - `payroll_type` string: Whether it is regular or bonus payroll
      - `check_date` string: Check date of this payroll.
      - `gross_pay` string: Gross pay for this employee on the payroll.
      - `imputed_pay` string: Total imputed pay for this employee on the payroll.
      - `company_benefit_deduction` string: The employee benefit deduction amount for this employee on the payroll.
      - `company_benefit_contribution` string: The company contribution amount for this employee on the payroll.
      - `pay_period` object
        - `start_date` string, nullable: The beginning of the payroll's pay period.
        - `end_date` string, nullable: The end of the payroll's pay period.

## Other responses

- `404`: Not Found The requested resource does not exist. Make sure the provided UUID is valid.

---

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