curl --request POST \
--url 'https://sandbox.rollfi.xyz/payroll#importPayrollHistory' \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"method": "importPayrollHistory",
"companyName": "paystub ytd test inc",
"payPeriod": {
"payPeriodType": "Regular",
"workerType": "W2",
"payBeginDate": "2025-04-01",
"payEndDate": "2025-06-30",
"deadLineToRunPayroll": "2025-06-26",
"payDate": "2025-06-30",
"payrollData": [
{
"firstName": "Jeromy",
"middleName": "",
"lastName": "Asp",
"payDetails": {
"baseTotal": 7324.42,
"grossTotal": 9284.8,
"netTotal": 7529.69,
"payRate": 0
},
"additionalCompensation": [
{
"description": "Bonus",
"amount": 1024.92
},
{
"description": "Qualified Parking",
"amount": 157.68
},
{
"description": "Severance Pay",
"amount": 777.78
}
],
"overTime": [
{
"type": "Comp off OT",
"noOfHours": 10,
"multiplier": 1
}
],
"deductions": [
{
"description": "403B CU 15 year Reg",
"amount": 10
},
{
"description": "125DC Reg",
"amount": 50
}
],
"reimbursements": [
{
"reimbursementType": "GYM",
"amount": 120
}
],
"taxCalculationResponses": [
{
"taxState": "FED",
"taxName": "Federal Income Tax",
"taxType": "Employee",
"taxAmount": 604.55
},
{
"taxState": "FED",
"taxName": "Social Security",
"taxType": "Employee",
"taxAmount": 575.66
},
{
"taxState": "FED",
"taxName": "Medicare",
"taxType": "Employee",
"taxAmount": 134.63
},
{
"taxState": "MN",
"taxName": "Income Tax",
"taxType": "Employee",
"taxAmount": 440.27
},
{
"taxState": "FED",
"taxName": "FUTA Employer",
"taxType": "Employer",
"taxAmount": 10.36
},
{
"taxState": "FED",
"taxName": "Social Security Employer",
"taxType": "Employer",
"taxAmount": 575.66
},
{
"taxState": "FED",
"taxName": "Medicare Employer",
"taxType": "Employer",
"taxAmount": 134.63
},
{
"taxState": "MN",
"taxName": "SUI Employer",
"taxType": "Employer",
"taxAmount": 89.13
},
{
"taxState": "MN",
"taxName": "Workforce Development Fee",
"taxType": "Employer",
"taxAmount": 9.28
},
{
"taxState": "MN",
"taxName": "Additional Assessment",
"taxType": "Employer",
"taxAmount": 4.46
}
]
},
{
"firstName": "Carrie",
"middleName": "",
"lastName": "Fricke",
"payDetails": {
"baseTotal": 9000,
"grossTotal": 9000,
"netTotal": 7590,
"payRate": 0
},
"additionalCompensation": [
{
"description": "Bonus",
"amount": 1024.92
},
{
"description": "Qualified Parking",
"amount": 157.68
}
],
"overTime": [
{
"type": "Comp off OT",
"noOfHours": 20,
"multiplier": 1
}
],
"deductions": [
{
"description": "403B CU 15 year Reg",
"amount": 10
},
{
"description": "125DC Reg",
"amount": 50
}
],
"reimbursements": [
{
"reimbursementType": "GYM",
"amount": 120
}
],
"taxCalculationResponses": [
{
"taxState": "FED",
"taxName": "Federal Income Tax",
"taxType": "Employee",
"taxAmount": 570.36
},
{
"taxState": "FED",
"taxName": "Social Security",
"taxType": "Employee",
"taxAmount": 558
},
{
"taxState": "FED",
"taxName": "Medicare",
"taxType": "Employee",
"taxAmount": 130.5
},
{
"taxState": "MN",
"taxName": "Income Tax",
"taxType": "Employee",
"taxAmount": 151.14
},
{
"taxState": "FED",
"taxName": "FUTA Employer",
"taxType": "Employer",
"taxAmount": 6
},
{
"taxState": "FED",
"taxName": "Social Security Employer",
"taxType": "Employer",
"taxAmount": 558
},
{
"taxState": "FED",
"taxName": "Medicare Employer",
"taxType": "Employer",
"taxAmount": 130.5
},
{
"taxState": "MN",
"taxName": "SUI Employer",
"taxType": "Employer",
"taxAmount": 86.4
},
{
"taxState": "MN",
"taxName": "Workforce Development Fee",
"taxType": "Employer",
"taxAmount": 9
},
{
"taxState": "MN",
"taxName": "Additional Assessment",
"taxType": "Employer",
"taxAmount": 4.32
}
]
}
]
}
}
'{
"importPayrollHistory": {
"payPeriodId": "E80A9618-6046-4A5C-BC9F-44A2A0E9B9A0",
"status": "Ready",
"message": "Payroll history imported successfully"
}
}The importPayrollHistory API loads a completed pay period into Rollfi so legacy payroll appears in reports and year-to-date calculations.
curl --request POST \
--url 'https://sandbox.rollfi.xyz/payroll#importPayrollHistory' \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"method": "importPayrollHistory",
"companyName": "paystub ytd test inc",
"payPeriod": {
"payPeriodType": "Regular",
"workerType": "W2",
"payBeginDate": "2025-04-01",
"payEndDate": "2025-06-30",
"deadLineToRunPayroll": "2025-06-26",
"payDate": "2025-06-30",
"payrollData": [
{
"firstName": "Jeromy",
"middleName": "",
"lastName": "Asp",
"payDetails": {
"baseTotal": 7324.42,
"grossTotal": 9284.8,
"netTotal": 7529.69,
"payRate": 0
},
"additionalCompensation": [
{
"description": "Bonus",
"amount": 1024.92
},
{
"description": "Qualified Parking",
"amount": 157.68
},
{
"description": "Severance Pay",
"amount": 777.78
}
],
"overTime": [
{
"type": "Comp off OT",
"noOfHours": 10,
"multiplier": 1
}
],
"deductions": [
{
"description": "403B CU 15 year Reg",
"amount": 10
},
{
"description": "125DC Reg",
"amount": 50
}
],
"reimbursements": [
{
"reimbursementType": "GYM",
"amount": 120
}
],
"taxCalculationResponses": [
{
"taxState": "FED",
"taxName": "Federal Income Tax",
"taxType": "Employee",
"taxAmount": 604.55
},
{
"taxState": "FED",
"taxName": "Social Security",
"taxType": "Employee",
"taxAmount": 575.66
},
{
"taxState": "FED",
"taxName": "Medicare",
"taxType": "Employee",
"taxAmount": 134.63
},
{
"taxState": "MN",
"taxName": "Income Tax",
"taxType": "Employee",
"taxAmount": 440.27
},
{
"taxState": "FED",
"taxName": "FUTA Employer",
"taxType": "Employer",
"taxAmount": 10.36
},
{
"taxState": "FED",
"taxName": "Social Security Employer",
"taxType": "Employer",
"taxAmount": 575.66
},
{
"taxState": "FED",
"taxName": "Medicare Employer",
"taxType": "Employer",
"taxAmount": 134.63
},
{
"taxState": "MN",
"taxName": "SUI Employer",
"taxType": "Employer",
"taxAmount": 89.13
},
{
"taxState": "MN",
"taxName": "Workforce Development Fee",
"taxType": "Employer",
"taxAmount": 9.28
},
{
"taxState": "MN",
"taxName": "Additional Assessment",
"taxType": "Employer",
"taxAmount": 4.46
}
]
},
{
"firstName": "Carrie",
"middleName": "",
"lastName": "Fricke",
"payDetails": {
"baseTotal": 9000,
"grossTotal": 9000,
"netTotal": 7590,
"payRate": 0
},
"additionalCompensation": [
{
"description": "Bonus",
"amount": 1024.92
},
{
"description": "Qualified Parking",
"amount": 157.68
}
],
"overTime": [
{
"type": "Comp off OT",
"noOfHours": 20,
"multiplier": 1
}
],
"deductions": [
{
"description": "403B CU 15 year Reg",
"amount": 10
},
{
"description": "125DC Reg",
"amount": 50
}
],
"reimbursements": [
{
"reimbursementType": "GYM",
"amount": 120
}
],
"taxCalculationResponses": [
{
"taxState": "FED",
"taxName": "Federal Income Tax",
"taxType": "Employee",
"taxAmount": 570.36
},
{
"taxState": "FED",
"taxName": "Social Security",
"taxType": "Employee",
"taxAmount": 558
},
{
"taxState": "FED",
"taxName": "Medicare",
"taxType": "Employee",
"taxAmount": 130.5
},
{
"taxState": "MN",
"taxName": "Income Tax",
"taxType": "Employee",
"taxAmount": 151.14
},
{
"taxState": "FED",
"taxName": "FUTA Employer",
"taxType": "Employer",
"taxAmount": 6
},
{
"taxState": "FED",
"taxName": "Social Security Employer",
"taxType": "Employer",
"taxAmount": 558
},
{
"taxState": "FED",
"taxName": "Medicare Employer",
"taxType": "Employer",
"taxAmount": 130.5
},
{
"taxState": "MN",
"taxName": "SUI Employer",
"taxType": "Employer",
"taxAmount": 86.4
},
{
"taxState": "MN",
"taxName": "Workforce Development Fee",
"taxType": "Employer",
"taxAmount": 9
},
{
"taxState": "MN",
"taxName": "Additional Assessment",
"taxType": "Employer",
"taxAmount": 4.32
}
]
}
]
}
}
'{
"importPayrollHistory": {
"payPeriodId": "E80A9618-6046-4A5C-BC9F-44A2A0E9B9A0",
"status": "Ready",
"message": "Payroll history imported successfully"
}
}Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.
Show child attributes