---
title: "Get Deductions for Individuals"
method: GET
path: "/employer/benefits/{benefit_id}/individuals"
tags: ["Deductions"]
---

# Get Deductions for Individuals

`GET /employer/benefits/{benefit_id}/individuals`

Get enrollment information for the given individuals.

## Query parameters

- `entity_ids` string[]
- `individual_ids` string

## Headers

- `Finch-API-Version` string, date, required

## Response `200`

Success

- object[]
  - `individual_id` string, required
  - `code` integer, required
  - `body` union, required
    - object
      - `employee_deduction` union, required — Employee deduction configuration. Supports both fixed amounts (in cents) and percentage-based contributions (in basis points where 100 = 1%).
        - object
          - `type` 'fixed', required — Contribution type. Supported values: "fixed" (amount in cents) or "percent" (amount in basis points).
          - `amount` integer, required — Contribution amount in cents (for type=fixed) or basis points (for type=percent, where 100 = 1%).
        - object
          - `type` 'percent', required — Contribution type. Supported values: "fixed" (amount in cents) or "percent" (amount in basis points).
          - `amount` integer, required — Contribution amount in cents (for type=fixed) or basis points (for type=percent, where 100 = 1%).
        - unknown
      - `company_contribution` union, required — Company contribution configuration. Supports fixed amounts (in cents), percentage-based contributions (in basis points where 100 = 1%), or tiered matching structures.
        - object
          - `type` 'fixed', required — Contribution type. Supported values: "fixed" (amount in cents), "percent" (amount in basis points), or "tiered" (multi-tier matching).
          - `amount` integer, required — Contribution amount in cents (for type=fixed) or basis points (for type=percent, where 100 = 1%). Not used for type=tiered.
        - object
          - `type` 'percent', required — Contribution type. Supported values: "fixed" (amount in cents), "percent" (amount in basis points), or "tiered" (multi-tier matching).
          - `amount` integer, required — Contribution amount in cents (for type=fixed) or basis points (for type=percent, where 100 = 1%). Not used for type=tiered.
        - object
          - `type` 'tiered', required — Contribution type. Supported values: "fixed" (amount in cents), "percent" (amount in basis points), or "tiered" (multi-tier matching).
          - `tiers` object[], required — Array of tier objects defining employer match tiers based on employee contribution thresholds. Required when type=tiered.
            - `match` integer, required
            - `threshold` integer, required
        - unknown
      - `annual_maximum` integer, nullable, required — If the benefit supports annual maximum, the amount in cents for this individual.
      - `catch_up` boolean, nullable, required — If the benefit supports catch up (401k, 403b, etc.), whether catch up is enabled for this individual.
      - `hsa_contribution_limit` 'individual' | 'family' | 'null', nullable — Type for HSA contribution limit if the benefit is a HSA.
    - BatchError
      - `code` number, required
      - `finch_code` string
      - `message` string, required
      - `name` string, required

## Other responses

- `207` — Multi-Status (WebDAV)
- `404` — Benefit Not Found

---

[API](https://skmtc.net/finch-api/apis/api-reference.md) · [All operations](https://skmtc.net/finch-api/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/finch-api/api-reference/revisions/f1cca2cb0ef2/schema)