---
title: "Employment"
method: POST
path: "/employer/employment"
tags: ["Organization"]
---

# Employment

`POST /employer/employment`

Read individual employment and income data

## Headers

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

## Request body

- object — Individual Ids Request Body
  - `requests` object[], required — The array of batch requests.
    - `individual_id` string, required — A stable Finch `id` (UUID v4) for an individual in the company. There is no limit to the number of `individual_id` to send per request. It is preferantial to send all ids in a single request for Finch to optimize provider rate-limits.

## Response `200`

Employment data

- GetEmploymentResponse
  - `responses` object[], required
    - `individual_id` string, uuid — A stable Finch `id` (UUID v4) for an individual in the company.
    - `code` integer
    - `body` object
      - `id` string, uuid — A stable Finch `id` (UUID v4) for an individual in the company.
      - `first_name` string, nullable — The legal first name of the individual.
      - `middle_name` string, nullable — The legal middle name of the individual.
      - `last_name` string, nullable — The legal last name of the individual.
      - `title` string, nullable — The current title of the individual.
      - `manager` object, nullable — The manager object representing the manager of the individual within the org.
        - `id` string, uuid — A stable Finch `id` (UUID v4) for an individual in the company.
      - `department` object, nullable — The department object.
        - `name` string, nullable — The name of the department associated with the individual.
      - `employment` object, nullable — The employment object.
        - `type` 'employee' | 'contractor' | 'null', nullable — The main employment type of the individual.
        - `subtype` 'full_time' | 'intern' | 'part_time' | 'temp' | 'seasonal' | 'individual_contractor' | 'null', nullable — The secondary employment type of the individual. Options: `full_time`, `part_time`, `intern`, `temp`, `seasonal` and `individual_contractor`.
      - `start_date` string, nullable
      - `end_date` string, nullable
      - `latest_rehire_date` string, nullable
      - `is_active` boolean, nullable — `true` if the individual an an active employee or contractor at the company.
      - `employment_status` 'active' | 'deceased' | 'leave' | 'onboarding' | 'prehire' | 'retired' | 'terminated' | 'null', nullable — The detailed employment status of the individual. Available options: `active`, `deceased`, `leave`, `onboarding`, `prehire`, `retired`, `terminated`.
      - `class_code` string, nullable — Worker's compensation classification code for this employee
      - `location` Location, nullable
        - `line1` string, nullable — Street address or PO box.
        - `line2` string, nullable — Apartment, suite, unit, or building.
        - `city` string, nullable — City, district, suburb, town, or village.
        - `state` string, nullable — The state code.
        - `postal_code` string, nullable — The postal code or zip code.
        - `country` string, nullable — The 2-letter ISO 3166 country code.
        - `name` string, nullable
        - `source_id` string, nullable
      - `income` Income, nullable — The employee's income 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.
        - `unit` 'yearly' | 'quarterly' | 'monthly' | 'semi_monthly' | 'bi_weekly' | 'weekly' | 'daily' | 'hourly' | 'fixed' | 'null', nullable — The income unit of payment. Options: `yearly`, `quarterly`, `monthly`, `semi_monthly`, `bi_weekly`, `weekly`, `daily`, `hourly`, and `fixed`.
        - `amount` integer, nullable — The income amount in cents.
        - `currency` string, nullable — The currency code.
        - `effective_date` string, nullable — The date the income amount went into effect.
      - `income_history` Income[], nullable — The array of income history.
        - `unit` 'yearly' | 'quarterly' | 'monthly' | 'semi_monthly' | 'bi_weekly' | 'weekly' | 'daily' | 'hourly' | 'fixed' | 'null', nullable — The income unit of payment. Options: `yearly`, `quarterly`, `monthly`, `semi_monthly`, `bi_weekly`, `weekly`, `daily`, `hourly`, and `fixed`.
        - `amount` integer, nullable — The income amount in cents.
        - `currency` string, nullable — The currency code.
        - `effective_date` string, nullable — The date the income amount went into effect.
      - `custom_fields` object[], nullable — Custom fields for the individual. These are fields which are defined by the employer in the system.
        - `name` string
        - `value` unknown
      - `source_id` string, nullable — The source system's unique employment identifier for this individual
      - `work_id` string, nullable — This field is deprecated in favour of `source_id`

---

[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/ff61a38530df/schema)