The fulfillment object

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"
  }
}
AttributeDescription
id
string
Unique identifier for the fulfillment.
type
string
Identifies the purpose of the fulfillment. Currently, the only supported type is balancing.
company
string
ID of the company that the fulfillment relates to.
payment
string or null

ID of the payment created to settle the balance with the employer, if a transaction was required.

null when no variances were identified or when the net cash requirement was within the waiver threshold.

totals
object
Always contains three (3) values:
  • cash_requirement: The tax liability amount that the employer was directly debited (positive amount) or refunded (negative amount) on the fulfillment transaction. Matches the payment amount.
  • cash_requirement_waived: The tax liability amount that was waived by Check (e.g., fractional, de minimis amounts).
  • agency_refundable: The tax liability amount that has already been remitted to tax agencies, and may be refundable by the agency to the employer.
Note: totals is currently only available in Sandbox, and will be available in Production in June 2026.