Submit a filing's confirmation data
Save the confirmation data entered for a filing, or mark the filing as filed. Only the organization's own filer can submit, so self-managed filings must be enabled for the organization: a partner credential for its portfolio (a partner member must be assigned to the organization, or the organization must be assigned to no member), or the organization's admin, owner or organization API key. Send an Organization-Id, Connection-Id or Entity-Id selector to say which organization the filing belongs to. action is save_draft to store the data and keep the filing in FILING, or mark_filed to store it and mark the filing filed. A field you omit is left unchanged and a field you send as null is cleared.
Returns 404 if the filing does not exist or belongs to an organization your credential cannot access, 403 if the credential cannot submit for the organization or self-managed filings are not enabled, and 409 if the filing is not in FILING status.
Authorization
Headers
Release date, as YYYY-MM-DD. Defaults to 2026-07-21.
Target organization id (Organization-Id selector).
Target connection id; resolves to its organization.
Platform entity id; resolves to a connection's organization.
Optional source to disambiguate an Entity-Id.
Path parameters
The unique identifier of the filing.
Body
Save the entered data as a draft, or mark the filing as filed.
save_draftmark_filedThe confirmation id the jurisdiction issued for the payment.
The confirmation id the jurisdiction issued for the return.
Manual adjustment to the amount due.
Fees added to the amount due.
Penalties added to the amount due.
Discounts applied to the amount due.
Response
Kintsugi's unique identifier for the filing.
Organization the filing belongs to.
Display name of the organization the filing belongs to. null when the organization has no name set.
The registration this filing period is filed under, if any.
Lifecycle status of the filing.
UNFILEDFILEDFILINGPAUSEDSKIPPEDCANCELLEDISSUEThe kind of filing period: REGULAR, AMENDMENT or BACK_FILING (a legacy PREPAYMENT value may appear on historical rows).
Which taxes this filing covers, from the associated registration.
SALES_TAXUSE_TAXSALES_AND_USE_TAXRETAIL_DELIVERY_FEEISO 3166-1 alpha-2 country code of the filing jurisdiction.
State or province code, or '' for a country-level filing.
Human-readable jurisdiction name.
First day of the filing period, as YYYY-MM-DD.
Last day of the filing period, as YYYY-MM-DD.
When the return is due, as YYYY-MM-DD.
When the return was filed, as YYYY-MM-DD; null until filed.
Return confirmation id from the jurisdiction portal; null until filed.
Payment confirmation id from the jurisdiction portal; null until paid.
Date a paused filing auto-resumes, as YYYY-MM-DD; null when not paused.
Whether this filing is structurally eligible to be paused: it is not a back-filing, it is in a pauseable status, and its organization is on the auto-filing experience. The time-of-month pause window is not included; derive that client-side from dueDate.
Whether this filing can be approved. false when approval is blocked (for example by unapproved products or addresses), which disables the per-row Approve and file actions.
Why the filing was skipped, if it was; null otherwise.
Whether this period is a prepayment rather than a full return.
Whether this is the registration's final filing period.
Whether this is a state Retail Delivery Fee return, a separate filing from the state's sales tax return.
Number of transactions in the filing period.
The jurisdiction's filing portal URL, if known.
When the filing was approved, as an RFC-3339 UTC timestamp; null if not.
When the filing was created, as an RFC-3339 UTC timestamp.
ISO-4217 currency every amount on this filing is in; null until the filing's amounts settle.
Net amount due for the filing.
Calculated tax for the period.
Manual adjustment applied to the amount due.
Vendor/timely-filing discounts applied.
Fees added to the amount due.
Whether amountFees is a penalty, interest, or other fee. Null when the fee was recorded before the label existed.
PENALTYINTERESTOTHERPenalties added to the amount due.
Tax collected on transactions in the period.
Use tax owed for the period.
Gross sales in the period.
Total tax liability for the filing.
Tax remitted to the jurisdiction; 0 until filed.
Input VAT this filing claimed, subtracted from liability; 0 outside EU/UK VAT filings.
Prior-year input VAT pro-rata true-up on this filing; 0 until posted and outside EU/UK VAT filings.
Filing frequency from the associated registration.
UNKNOWNMONTHLYQUARTERLYSEMI_ANNUALLYANNUALLYANNUAL_FISCAL_YEARSEMI_MONTHLYBI_MONTHLYFOUR_MONTHLYQUARTERLY_PREPAYMENTOSS scheme (UNION/NON_UNION/IOSS) from the registration, if any.
UNIONNON_UNIONIOSSDisplay-only balance-due breakdown for CA Quarterly Prepayment reconciliation filings. When present, show balanceDue instead of totalTaxLiability. Absent means show totalTaxLiability as usual.
Display-only CDTFA Option 2 (135% of May liability) for CA Quarterly Prepayment May prepayment filings. Absent means show totalTaxLiability.
Display-only estimated penalties and interest for BACK_FILING rows. Null means unknown; zero is a genuine not-yet-late or zero-tax outcome.
Customer-facing P&I timing tag for BACK_FILING rows, e.g. 'Paid with return' or 'State bills you later'.
Sales composition for the period (taxable, exempt, marketplace count, credits utilized, deferred count). Absent unless the request passes expand=salesBreakdown.
EU/UK input-VAT recovery rate pair for the filing. Absent unless the request passes expand=vatRecovery.
The filing's return/payment/additional artifacts resolved by slot, each downloadable through the attachments API. Absent unless the request passes expand=artifacts.
Successful Response
The request was invalid.
Authentication failed or was missing.
The credential is not permitted for this request.
The requested resource was not found.
The request conflicts with existing state.
The request failed validation.