Payroll
Pay Statement
Deductions
Documents
Management
Sandbox
- POSTCreate a new Sandbox Connection
- POSTCreate a new sandbox account
- PUTUpdate a sandbox account
- GETGet configurations for sandbox jobs
- PUTUpdate configurations for sandbox jobs
- POSTAdd a new sandbox payment
- PUTUpdate sandbox individual
- PUTUpdate sandbox employment
- POSTAdd new individuals to a sandbox company
- PUTUpdate a sandbox company's data
- POSTEnqueue a new sandbox job
Development Guides
Payroll
Pay Statement
Read detailed pay statements for each individual.
Deduction and contribution types are supported by the payroll systems that supports Benefits.
POST
/
employer
/
pay-statement
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 payStatementResponse of client.hris.payStatements.retrieveMany({
requests: [{ payment_id: '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e' }],
})) {
console.log(payStatementResponse.payment_id);
}
}
main();
{
"responses": [
{
"payment_id": "fc8b024e-d373-4c9c-80fc-f1625383d142",
"code": 200,
"body": {
"paging": {
"count": 25,
"offset": 10
},
"pay_statements": [
{
"individual_id": "be7b048c-a6f3-4194-a017-2f537d4f3565",
"type": "regular_payroll",
"payment_method": "check",
"total_hours": 42.5,
"gross_pay": {
"amount": 230000,
"currency": "usd"
},
"net_pay": {
"amount": 180000,
"currency": "usd"
},
"earnings": [
{
"type": "salary",
"name": "Salary",
"amount": 230000,
"currency": "usd",
"hours": 42.5
}
],
"taxes": [
{
"type": "state",
"name": "State Withholding - OR",
"employer": false,
"amount": 0,
"currency": "usd"
}
],
"employee_deductions": [
{
"name": "Pre-Tax 401k",
"amount": 50000,
"currency": "usd",
"pre_tax": true,
"type": "401k"
}
],
"employer_contributions": [
{
"name": "Employee Medical Insurance",
"amount": 23272,
"currency": "usd"
}
]
}
]
}
}
]
}
Authorizations
Please use your Access Token
Headers
Header used to specify the version for a given API request. Current version is 2020-09-17.
Used to indicate the original media type of the resource
Body
application/json
Response
200 - application/json
Pay statement data
The response is of type object
.
Was this page helpful?
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 payStatementResponse of client.hris.payStatements.retrieveMany({
requests: [{ payment_id: '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e' }],
})) {
console.log(payStatementResponse.payment_id);
}
}
main();
{
"responses": [
{
"payment_id": "fc8b024e-d373-4c9c-80fc-f1625383d142",
"code": 200,
"body": {
"paging": {
"count": 25,
"offset": 10
},
"pay_statements": [
{
"individual_id": "be7b048c-a6f3-4194-a017-2f537d4f3565",
"type": "regular_payroll",
"payment_method": "check",
"total_hours": 42.5,
"gross_pay": {
"amount": 230000,
"currency": "usd"
},
"net_pay": {
"amount": 180000,
"currency": "usd"
},
"earnings": [
{
"type": "salary",
"name": "Salary",
"amount": 230000,
"currency": "usd",
"hours": 42.5
}
],
"taxes": [
{
"type": "state",
"name": "State Withholding - OR",
"employer": false,
"amount": 0,
"currency": "usd"
}
],
"employee_deductions": [
{
"name": "Pre-Tax 401k",
"amount": 50000,
"currency": "usd",
"pre_tax": true,
"type": "401k"
}
],
"employer_contributions": [
{
"name": "Employee Medical Insurance",
"amount": 23272,
"currency": "usd"
}
]
}
]
}
}
]
}