Preview a correction

Calculates the full effects of a correction and creates a preview fulfillment.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
🚧

In preview

The Correction API is currently in limited preview, and is not yet generally available.

Starts an asynchronous preview of a correction. Previewing a correction does two things:

  1. Rebalances each impacted closed quarter. If the correction changes pay history in a closed quarter, Check calculates the tax effects of rebalancing that quarter and attaches the resulting payrolls to the correction as balance_quarter operations.
  2. Prices the correction without moving money. Once the preview succeeds, totals is populated with the money-movement totals that would be required to fulfill the correction, using the same shape as fulfillment totals.

The endpoint returns 202 Accepted with the correction's preview object set to calculating. Monitor the preview's progress via the preview object on the correction, the same way payroll previews are monitored. When the preview fails, preview.messages describes why. A correction updated webhook is sent when the preview completes.

The preview is invalidated if payrolls are added to or deleted from the correction.

Path Params
string
required

ID of the correction to preview

Response

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json