GET
/
employer
/
benefits
/
{benefit_id}
/
individuals
JavaScript
import Finch from '@tryfinch/finch-api';

const client = new Finch({
  accessToken: 'My Access Token',
});

// Automatically fetches more pages as needed.
for await (const individualBenefit of client.hris.benefits.individuals.retrieveManyBenefits('benefit_id')) {
  console.log(individualBenefit.individual_id);
}
[
  {
    "individual_id": "d02a6346-1f08-4312-a064-49ff3cafaa7a",
    "code": 200,
    "body": {
      "employee_deduction": {
        "type": "fixed",
        "amount": 100
      },
      "company_contribution": {
        "type": "fixed",
        "amount": 100
      },
      "annual_maximum": 1000,
      "catch_up": false
    }
  },
  {
    "individual_id": "e63c21ab-7cde-49d8-b6d6-ce208e84bf09",
    "code": 200,
    "body": {
      "employee_deduction": {
        "type": "fixed",
        "amount": 100
      },
      "company_contribution": {
        "type": "fixed",
        "amount": 100
      },
      "annual_maximum": 1000,
      "catch_up": false
    }
  }
]
Availability: Automated providers only This is a live request to the provider. Latencies may vary from seconds to minutes depending on the provider and number of benefits.

Authorizations

​
Authorization
string
header
required

Please use your Access Token

Headers

​
Finch-API-Version
string<date>
default:2020-09-17
required

Header used to specify the version for a given API request. Current version is 2020-09-17.

Path Parameters

​
benefit_id
string
required

Query Parameters

​
individual_ids
string

comma-delimited list of stable Finch uuids for each individual. If empty, defaults to all individuals

Example:

"d675d2b7-6d7b-41a8-b2d3-001eb3fb88f6,d02a6346-1f08-4312-a064-49ff3cafaa7a"

Response

200
application/json

Success

The response is of type IndividualBenefits · object[].