Organization

Finch’s Organization product reads company and employee data from an employer’s HRIS or payroll system. Four read-only endpoints return the employer’s company details, a directory of the entire workforce, and personal and employment records for each individual.

​

What you can do

• Read the workforce directory — list every individual at the company, active and terminated; compare reads to detect new hires, terminations, and reporting-structure changes in your system.
• Read employment details — title, department, employment status, compensation, start date, and work location for every employee.
• Read company information — Finch returns the employer’s legal name, Employer Identification Number (EIN), and corporate address; use them to verify the employer in your records.
• Trigger downstream workflows — subscribe to webhooks to start onboarding, offboarding, or eligibility processes in your product when employment data changes.

​

Organization endpoints

/individual and /employment are batch read endpoints: pass the individual_id values returned by /directory in the request body. See Read data for the request pattern.

​

Provider coverage

Field availability varies by provider. Check the Field Support matrix to confirm that the fields your use case requires are available from the providers your customers use.

​

Common use cases

• Workforce management — trigger onboarding and offboarding processes when employees join or leave.
• Compensation management — benchmark compensation by title, department, location, and tenure.
• Workers’ compensation — improve premium accuracy with job title, location, and pay data read directly from the employer’s system.
• Security and compliance — keep certification and access requirements current with live directory data.
• People analytics — power workforce insights with organization and demographic data.

​

Next steps

Questions about whether Organization fits your use case? Contact developers@tryfinch.com or talk to our team.