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

const finch = new Finch();

async function main() {
  // Automatically fetches more pages as needed.
  for await (const payment of finch.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"
    ]
  }
]

Authorizations

Authorization
string
headerrequired

Please use your Access Token

Headers

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

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
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.