- Changelog
- API Status
- GETGet All Deductions
- POSTRegister Deduction
- POSTCreate Deduction
- GETGet Deduction
- POSTUpdate Deduction
- GETGet Enrolled Individuals
- GETGet Deductions for Individuals
- POSTEnroll Individuals in Deductions
- DELUnenroll Individuals from Deductions
- POSTCreate Access Token
- GETProviders
- GETIntrospect
- POSTDisconnect
- POSTRequest Forwarding
- GETList All Automated Jobs
- POSTEnqueue a New Automated Job
- GETRetrieve an Automated Job
- GETRetrieve a Manual Job
- POSTCreate a new Sandbox Connection
- POSTCreate a new sandbox account
- PUTUpdate a sandbox account
- GETGet configurations for sandbox jobs
- PUTUpdate configurations for sandbox jobs
- POSTAdd a new sandbox payment
- PUTUpdate sandbox individual
- PUTUpdate sandbox employment
- POSTAdd new individuals to a sandbox company
- PUTUpdate a sandbox company's data
- POSTEnqueue a new sandbox job
Deductions
Management
Sandbox
Individual
Read individual data, excluding income and employment data
Please use your Access Token
Header used to specify the version for a given API request. Current version is 2020-09-17.
Used to indicate the original media type of the resource
import Finch from '@tryfinch/finch-api';
const finch = new Finch();
async function main() {
// Automatically fetches more pages as needed.
for await (const individualResponse of finch.hris.individuals.retrieveMany()) {
console.log(individualResponse.individual_id);
}
}
main();
{
"responses": [
{
"individual_id": "5d0b10a1-a09a-430f-81f1-20be735dc5e9",
"code": 200,
"body": {
"id": "5d0b10a1-a09a-430f-81f1-20be735dc5e9",
"first_name": "Jane",
"middle_name": null,
"last_name": "Doe",
"preferred_name": "Janey",
"emails": [
{
"data": "jane@acme.com",
"type": "work"
},
{
"data": "janed@personal.com",
"type": "personal"
}
],
"phone_numbers": [
{
"data": "5051234567",
"type": "personal"
}
],
"gender": "female",
"ethnicity": "black_or_african_american",
"dob": "1970-01-01",
"residence": {
"line1": "123 Main St",
"line2": "Apt C",
"city": "Schenectady",
"state": "NY",
"postal_code": "12345",
"country": "US"
}
}
}
]
}
Authorizations
Please use your Access Token
Headers
Header used to specify the version for a given API request. Current version is 2020-09-17.
Used to indicate the original media type of the resource
Body
Response
A stable Finch id
(UUID v4) for an individual in the company.
The legal first name of the individual.
The legal middle name of the individual.
The legal last name of the individual.
The preferred name of the individual.
work
, personal
,
work
, personal
,
The gender of the individual.
female
, male
, other
, decline_to_specify
,
The EEOC-defined ethnicity of the individual.
asian
, white
, black_or_african_american
, native_hawaiian_or_pacific_islander
, american_indian_or_alaska_native
, hispanic_or_latino
, two_or_more_races
, decline_to_specify
,
Street address or PO box.
Apartment, suite, unit, or building.
City, district, suburb, town, or village.
The state code.
The postal code or zip code.
The 2-letter ISO 3166 country code.
Social Security Number of the individual. This field is only available with the ssn
scope enabled and the options: { include: ['ssn'] }
param set in the body.
Social Security Number of the individual in encrypted format. This field is only available with the ssn
scope enabled and the options: { include: ['ssn'] }
param set in the body.
Was this page helpful?
import Finch from '@tryfinch/finch-api';
const finch = new Finch();
async function main() {
// Automatically fetches more pages as needed.
for await (const individualResponse of finch.hris.individuals.retrieveMany()) {
console.log(individualResponse.individual_id);
}
}
main();
{
"responses": [
{
"individual_id": "5d0b10a1-a09a-430f-81f1-20be735dc5e9",
"code": 200,
"body": {
"id": "5d0b10a1-a09a-430f-81f1-20be735dc5e9",
"first_name": "Jane",
"middle_name": null,
"last_name": "Doe",
"preferred_name": "Janey",
"emails": [
{
"data": "jane@acme.com",
"type": "work"
},
{
"data": "janed@personal.com",
"type": "personal"
}
],
"phone_numbers": [
{
"data": "5051234567",
"type": "personal"
}
],
"gender": "female",
"ethnicity": "black_or_african_american",
"dob": "1970-01-01",
"residence": {
"line1": "123 Main St",
"line2": "Apt C",
"city": "Schenectady",
"state": "NY",
"postal_code": "12345",
"country": "US"
}
}
}
]
}