Recalculate a filing

POST/filings/{filing_id}/recalculate

Queue a recalculation of a filing's amounts from its transactions. Only an administrator of a caller that files the organization's returns itself may recalculate: a partner with self-managed filings enabled (its portfolio key, or a partner ADMIN or OWNER), or the organization's own ADMIN, OWNER or organization key, or a reseller key for the portfolio that holds it, when such a partner manages it. Send an Organization-Id, Connection-Id or Entity-Id selector to say which organization it belongs to. Returns 202 with status: QUEUED; the recalculation runs in the background, so read the filing again for the new amounts.

Only US and Canadian filings that are not in FILING, SUBMITTED or FILED status can be recalculated. Returns 404 if the filing does not exist or belongs to an organization your credential cannot access, 403 if Kintsugi files the organization's returns or your credential is not an administrator of its filer, and 400 if the filing cannot be recalculated.

Authorization

Api-KeystringRequired

Your secret API key. Include it with every request.

Headers

Api-Versiondate

Release date, as YYYY-MM-DD. Defaults to 2026-10-06.

Organization-Idstring

Target organization id (Organization-Id selector).

Connection-Idstring

Target connection id; resolves to its organization.

Entity-Idstring

Platform entity id; resolves to a connection's organization.

Entity-Sourcestring

Optional source to disambiguate an Entity-Id.

Path parameters

filing_idstringRequired

The unique identifier of the filing.

Response

filingIdstringRequired

Kintsugi's unique identifier for the filing.

countryCodestringRequired

ISO 3166-1 alpha-2 country code of the filing's jurisdiction.

statusPublicFilingRecalculationStatusEnumRequired

QUEUED once the recalculation is queued. Poll GET /filings/{filingId} for the recalculated amounts.

Available options:QUEUED

202

Successful Response

400

The request was invalid.

401

Authentication failed or was missing.

403

The credential is not permitted for this request.

404

The requested resource was not found.

409

The request conflicts with existing state.

422

The request failed validation.

cURL

POST /filings/{filing_id}/recalculate

-H "Api-Key: ***"

-H "Api-Version: 2026-10-06"

Example request

https://api.trykintsugi.com/filings/{filing_id}/recalculate

Response

{

"filingId": "file_2mNpQr7Ls8f3k",

"countryCode": "US",

"status": "QUEUED"

}