Skip to main content
POST
/
payroll#importPayrollHistory
importPayrollHistory
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"
  }
}

Authorizations

Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Body

application/json
method
string
required
companyName
string
required
companyId
string
required
payPeriod
object
required

Response

importPayrollHistory
object
required