Finch

Finch is a unified employment API providing standardized read and write access to HRIS, payroll, and benefits systems. Through a single integration, developers can pull company directory data, individual PII, employment records, payments, pay statements, and benefits across hundreds of providers (ADP, Gusto, Paylocity, Workday, BambooHR, Rippling, Justworks, TriNet, and more). Finch Connect handles end-user authorization via OAuth.

1 APIs 0 Features

EmploymentHRISPayrollBenefitsHRUnified APIWorkforce

APIs

Finch API

Unified REST API for HRIS, payroll, and benefits providers. Supports Company, Directory, Individual, Employment, Payment, Pay Statement, and Benefits resources. Authentication u...

Collections

Finch API

OPEN

Pricing Plans

Finch Plans Pricing

3 plans

PLANS

Rate Limits

Finch Rate Limits

5 limits

RATE LIMITS

FinOps

Finch Finops

FINOPS

Resources

👥

GitHubOrganization

Sources

opencollection: 1.0.0
info:
  name: Finch API
  version: '2024-04-01'
request:
  auth:
    type: bearer
    token: '{{bearerToken}}'
items:
- info:
    name: Create a Finch Connect session
    type: http
  http:
    method: POST
    url: https://api.tryfinch.com/connect/sessions
    body:
      type: json
      data: '{}'
  docs: Initializes the Connect authorization flow for an end-user.
- info:
    name: Exchange authorization code for access token
    type: http
  http:
    method: POST
    url: https://api.tryfinch.com/auth/token
    body:
      type: json
      data: '{}'
  docs: Exchange authorization code for access token
- info:
    name: Get connected company information
    type: http
  http:
    method: GET
    url: https://api.tryfinch.com/employer/company
  docs: Get connected company information
- info:
    name: List employees in the company directory
    type: http
  http:
    method: GET
    url: https://api.tryfinch.com/employer/directory
    params:
    - name: limit
      value: ''
      type: query
    - name: offset
      value: ''
      type: query
  docs: List employees in the company directory
- info:
    name: Get individual records (PII)
    type: http
  http:
    method: POST
    url: https://api.tryfinch.com/employer/individual
    body:
      type: json
      data: '{}'
  docs: Get individual records (PII)
- info:
    name: Get employment records
    type: http
  http:
    method: POST
    url: https://api.tryfinch.com/employer/employment
    body:
      type: json
      data: '{}'
  docs: Get employment records
- info:
    name: List company payments (pay runs)
    type: http
  http:
    method: GET
    url: https://api.tryfinch.com/employer/payment
    params:
    - name: start_date
      value: ''
      type: query
    - name: end_date
      value: ''
      type: query
  docs: List company payments (pay runs)
- info:
    name: Get pay statements for one or more payments
    type: http
  http:
    method: POST
    url: https://api.tryfinch.com/employer/pay-statement
    body:
      type: json
      data: '{}'
  docs: Get pay statements for one or more payments
- info:
    name: List company benefits
    type: http
  http:
    method: GET
    url: https://api.tryfinch.com/employer/benefits
  docs: List company benefits
bundled: true