Skip to main content
POST
/
employer
/
employment
JavaScript
import Finch from '@tryfinch/finch-api';

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

// Automatically fetches more pages as needed.
for await (const employmentDataResponse of client.hris.employments.retrieveMany({
  requests: [{ individual_id: 'individual_id' }],
})) {
  console.log(employmentDataResponse.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", "title": "Customer Support", "manager": { "id": "c205b3fa-b626-4346-bf0f-ca065ab88d31" }, "department": { "name": "Product" }, "employment": { "type": "employee", "subtype": "full_time" }, "start_date": "2017-06-30", "end_date": null, "latest_rehire_date": null, "is_active": true, "employment_status": "onboarding", "flsa_status": "exempt", "class_code": "8810", "location": { "line1": "12 Bird Drive", "line2": null, "city": "Palo Alto", "state": "CA", "postal_code": "94301", "country": "US" }, "income": { "unit": "yearly", "amount": 10000000, "currency": "usd", "effective_date": "2019-03-01" }, "income_history": [ { "unit": "yearly", "amount": 9000000, "currency": "usd", "effective_date": "2018-05-15" }, { "unit": "yearly", "amount": 8000000, "currency": "usd", "effective_date": "2017-06-30" } ], "custom_fields": [ { "name": "tShirtSize", "value": "L" } ], "source_id": "VWK-88a8505d" } } ] }

Documentation Index

Fetch the complete documentation index at: https://developer.tryfinch.com/llms.txt

Use this file to discover all available pages before exploring further.

Note: Income information is returned as reported by the provider. This may not always be annualized income, but may be in units of bi-weekly, semi-monthly, daily, etc, depending on what information the provider returns.

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.

Pattern: ([12]\d{3}-(0[1-9]|1[0-2])-(0[1-9]|[12]\d|3[01]))
​
Content-Type
string
default:application/json
required

Used to indicate the original media type of the resource

Query Parameters

​
entity_ids
string<uuid>[]

The entity IDs to specify which entities' data to access.

Required array length: 1 element
Example:
["550e8400-e29b-41d4-a716-446655440000"]

Body

application/json

Individual Ids Request Body

​
requests
object[]
required

The array of batch requests.

Response

Employment data

​
responses
object[]
required