GET
/
employer
/
payment
import Finch from '@tryfinch/finch-api';

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

async function main() {
  // Automatically fetches more pages as needed.
  for await (const payment of client.hris.payments.list({
    end_date: '2021-01-01',
    start_date: '2021-01-01',
  })) {
    console.log(payment.id);
  }
}

main();
[
  {
    "id": "20aa7cf2-949d-4d4e-9c01-499b59501ded",
    "pay_period": {
      "start_date": "2019-08-01",
      "end_date": "2019-08-15"
    },
    "pay_date": "2019-08-22",
    "debit_date": "2019-08-22",
    "company_debit": {
      "amount": 5300000,
      "currency": "usd"
    },
    "gross_pay": {
      "amount": 4000000,
      "currency": "usd"
    },
    "net_pay": {
      "amount": 3200000,
      "currency": "usd"
    },
    "employer_taxes": {
      "amount": 200000,
      "currency": "usd"
    },
    "employee_taxes": {
      "amount": 350000,
      "currency": "usd"
    },
    "individual_ids": [
      "54719e14-5ea7-4fda-9898-f4d9ccb83c1a",
      "0ab620fc-203e-44ad-916c-facc69250f6f"
    ],
    "pay_group_ids": [
      "5d0b10a1-a09a-430f-81f1-20be735dc5e9",
      "9349eed4-4064-4641-ba8e-9e1ad7e1d014"
    ],
    "pay_frequencies": [
      "monthly",
      "weekly"
    ]
  }
]

Authorizations

​
Authorization
string
header
required

Please use your Access Token

Headers

​
Finch-API-Version
string
default:
2020-09-17
required

Header used to specify the version for a given API request. Current version is 2020-09-17.

Query Parameters

​
start_date
string
required

The start date to retrieve payments by a company (inclusive) in YYYY-MM-DD format.

​
end_date
string
required

The end date to retrieve payments by a company (inclusive) in YYYY-MM-DD format.

Response

200 - application/json
Payment data
​
id
string

The unique id for the payment.

​
pay_period
object | null

The pay period object.

​
pay_date
string | null
​
debit_date
string | null
​
company_debit
object | null
​
gross_pay
object | null
​
net_pay
object | null
​
employer_taxes
object | null
​
employee_taxes
object | null
​
individual_ids
string[] | null

Array of every individual on this payment.

​
pay_group_ids
string[] | null

Array of the Finch id (uuidv4) of every pay group associated with this payment.

​
pay_frequencies
enum<string>[] | null

List of pay frequencies associated with this payment.

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

Was this page helpful?

EmploymentPay Statement