POST
/
employer
/
individual
import Finch from '@tryfinch/finch-api';

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

// Automatically fetches more pages as needed.
for await (const individualResponse of client.hris.individuals.retrieveMany()) {
  console.log(individualResponse.individual_id);
}
{
"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": "+14475678901",
"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

Authorization
string
header
required

Please use your Access Token

Headers

Finch-API-Version
string
default:2020-09-17
required

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

Content-Type
string
default:application/json
required

Used to indicate the original media type of the resource

Body

application/json

Response

200
application/json

Individual data

The response is of type object.