API changelog: 2026
Every change to the Kintsugi API in 2026, newest first. For the latest changes and every release, see the API changelog.
2026-11-02
Breaking changesAnswers 409 when you approve a filing that is being recalculatedFilingsBreaking change
Approving a filing now answers 409 while the filing is being recalculated, instead of approving it on amounts that may be out of date. On the Tenanted releases the error code is recalculation_in_progress, a new value of the error code enum. The recalculation finishes within moments, so the same request succeeds when you retry it.
- Handle
409on an approval by waiting a few seconds and sending the same request again. - On the Tenanted releases, tell this
409apart from the duplicate-period409by itscode, and treat an unknowncodeas a failure rather than a retry.
2026-10-27
Breaking changesRemoves the filing enhanced data endpointsFilingsBreaking change
GET /filings/{filing_id}/enhanced-data and POST /filings/{filing_id}/enhanced-data/rebuild are no longer available on any Tenanted release, including integrations pinned to 2026-07-21 or 2026-10-06. Requests to them answer 404. Read a filing's totals from GET /filings/{filing_id}.
- Stop calling
GET /filings/{filing_id}/enhanced-dataandPOST /filings/{filing_id}/enhanced-data/rebuild. - Read filing amounts from
GET /filings/{filing_id}instead.
2026-10-20
Breaking changesShows Kintsugi's own task files only as payment receiptsFilingsBreaking change
An attachment Kintsugi adds while working on your account is now visible to you only when it is the state's payment receipt for a balance that is paid. GET /attachments leaves every other such file out. GET /attachments/{attachment_id} and GET /attachments/{attachment_id}/download answer 404 for it, the same answer as an id that does not exist. Files you upload yourself are unchanged.
- Treat
404from the attachment endpoints as final for a file that is not shared with you, and do not retry it. - Read payment receipts from
paymentConfirmationAttachmentIdson aPAIDproposal outcome fromGET /proposals.
2026-10-14
Breaking changesSplits the filing submission into a draft PATCH and a mark-filed POST on 2026-10-06FilingsBreaking change
On Api-Version: 2026-10-06, PUT /filings/{filing_id}/submission no longer exists and answers 405. PATCH /filings/{filing_id}/submission saves the confirmation fields as a draft and leaves the filing status unchanged. POST /filings/{filing_id}/mark-filed stores any confirmation fields you send and marks the filing FILED. Neither takes action. Repeating a mark-filed request for a filing already filed with the same values answers 200 with the filing and does nothing more, where the PUT answered 409. Both new endpoints answer 409 when the filing is not in FILING or SUBMITTED status. 2026-07-21 keeps the PUT with action. On every Api-Version, amountAdjusted, amountFees, amountPenalties and amountDiscounts now answer 422 when sent as null; before, null was stored as 0.00. Send an amount, including "0.00", or leave it out. returnConfirmationId and paymentConfirmationId still clear when sent as null.
- On
Api-Version: 2026-10-06, callPATCH /filings/{filing_id}/submissionto save a draft andPOST /filings/{filing_id}/mark-filedto mark the filing filed. - Retry
mark-filedafter a timeout without checking the filing first: an identical repeat answers200. - Stop sending
nullfor an amount. Send"0.00"for zero, or leave the amount out.
2026-10-08
Breaking changesRemoves retail delivery fee fields from v1 filings and registrationsFilingsBreaking change
A retail delivery fee is now its own registration and its own filing, so v1 no longer returns the fields that flagged it on a sales tax record. is_rdf is gone from filing responses, and retail_delivery_fee_obligated and retail_delivery_fee_effective_from are gone from registration responses. Read tax_type instead: a retail delivery fee registration or filing has tax_type RETAIL_DELIVERY_FEE, and it appears beside the state's sales tax record rather than inside it. On POST /v1/registrations for Colorado, retail_delivery_fee_obligated still asks for a retail delivery fee registration, opened beside the sales registration, but the value is no longer stored or returned on the sales registration. It is available to paid organizations with this feature enabled; for any other organization, a request that sets it answers 400.
- GET/v1/filingsv1
- GET/v1/filings/{filing_id}v1
- GET/v1/filings/registration/{registration_id}v1
- POST/v1/filings/back-filing-requestv1
- PUT/v1/filings/{filing_id}/approvev1
- GET/v1/registrationsv1
- GET/v1/registrations/{registration_id}v1
- POST/v1/registrationsv1
- POST/v1/registrations/{registration_id}/deregisterv1
- PUT/v1/registrations/{registration_id}v1
- Stop reading
is_rdf,retail_delivery_fee_obligatedandretail_delivery_fee_effective_fromfrom v1 responses. - Identify a retail delivery fee filing or registration by
tax_typeRETAIL_DELIVERY_FEE.
2026-10-05
Breaking changesLimits pausing a filing to the window before its due dateFilingsBreaking change
Pausing a filing now follows the same window as the Kintsugi app. After the 15th of the month a filing is due, it can no longer be paused with any pauseIntent, including assistance and skip, which were accepted before. A review pause also needs a pausedUntilDate from today through the 15th of the due month; a date in the past, accepted before, is now refused. A date that is still today anywhere in the world counts as today. POST /filings/{filing_id}/pause answers a refused pause with 400 and code invalid_request, and POST /filings/bulk/pause still answers 200, listing each refused filing in failed.
- Pause a filing no later than the 15th of the month it is due.
- For a
reviewpause, send apausedUntilDateno earlier than today and no later than the 15th of the due month. - After a bulk pause, check
failedfor filings that were not paused.