Fulfillments capture the result of a tax liability adjustment for a company. Tax liability adjustments can happen for a variety of reasons, including end of quarter balancing calculations or payroll corrections.
Fulfillments may or may not result in a direct transaction with the employer. When the outcome involves only agency refunds or waivers — with no net cash requirement from the employer — the payment field will be null.
A breakdown of the individual tax liabilities on a Fulfillment is accessible by the fulfillment receipt, which is a downloadable PDF receipt summarizing the tax liabilities and the resolution for each.
{
"id": "ful_9JU4EupBW2RlHTTUynKg",
"type": "balancing",
"company": "com_1XHqR9Qf5t18SD2sfYEe",
"payment": "pyt_sxg3xaLAs3GefGYAGgz",
"totals": {
"cash_requirement": "1000.00",
"cash_requirement_waived": "0.00",
"agency_refundable": "125.00"
}
}| Attribute | Description |
|---|---|
idstring | Unique identifier for the fulfillment. |
typestring | Identifies the purpose of the fulfillment. Currently, the only supported type is balancing. |
companystring | ID of the company that the fulfillment relates to. |
paymentstring or null | ID of the payment created to settle the balance with the employer, if a transaction was required.
|
totalsobject | Always contains three (3) values:
totals is currently only available in Sandbox, and will be available in Production in June 2026. |

