Skip to main content
GET
/
employer
/
pay-groups
JavaScript
import Finch from '@tryfinch/finch-api';

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

// Automatically fetches more pages as needed.
for await (const payGroupListResponse of client.payroll.payGroups.list()) {
  console.log(payGroupListResponse.id);
}
[
  {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "pay_frequencies": [
      "annually"
    ]
  }
]

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.

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"]
individual_id
string<uuid>
pay_frequencies
string[]

Response

200 - application/json

Company pay groups

id
string<uuid>
required

Finch id (uuidv4) for the pay group

name
string
required

Name of the pay group

pay_frequencies
enum<string>[]
required

List of pay frequencies associated with this pay group

Available options:
annually,
bi_weekly,
daily,
monthly,
other,
quarterly,
semi_annually,
semi_monthly,
weekly