---
title: "[Deprecated] Get Deductions Metadata"
method: GET
path: "/employer/benefits/meta"
tags: ["Deductions"]
---

# [Deprecated] Get Deductions Metadata

`GET /employer/benefits/meta`

Get deductions metadata

## Query parameters

- `entity_ids` string[]

## Headers

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

## Response `200`

OK

- BenefitFeature[], nullable
  - `description` string, nullable, required
  - `frequencies` BenefitFrequency[], required — The list of frequencies supported by the provider for this benefit
  - `employee_deduction` string[], nullable, required — Supported deduction types. An empty array indicates deductions are not supported.
  - `company_contribution` string[], nullable, required — Supported contribution types. An empty array indicates contributions are not supported.
  - `annual_maximum` boolean, nullable, required — Whether the provider supports an annual maximum for this benefit.
  - `catch_up` boolean, nullable — Whether the provider supports catch up for this benefit. This field will only be true for retirement benefits.
  - `hsa_contribution_limit` string[], nullable — Whether the provider supports HSA contribution limits. Empty if this feature is not supported for the benefit. This array only has values for HSA benefits.

## Changes

> 53 revisions in range; 3 could not be searched.

- **2025-10-27** `0105d239fcaf` — 1 warning, 1 info
  - added the new `tiered` enum value to the `items/company_contribution/items/` response property for the response status `200`
  - added the new optional `query` request parameter `entity_ids`
- **2025-07-25** `73c284d36c1e` — 5 info
  - the response property `items/annual_maximum` became required for the status `200`
  - the response property `items/company_contribution` became required for the status `200`
  - the response property `items/description` became required for the status `200`
  - the response property `items/employee_deduction` became required for the status `200`
  - …1 more
- **2025-04-22** `46640c1b4688` — 1 info
  - the endpoint scheme security `bearerAuth` was added to the API
- **2025-04-10** `bf858f37d7ab` — 1 breaking, 1 warning
  - the response's body became nullable
  - removed the optional property `items/type` from the response with the `200` status

[Change history](https://skmtc.dev/finch-api/apis/api-reference/changes/employer/benefits/meta/get.md)

---

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