# Approve a filing

> POST /filings/{filing_id}/approve

Source: https://docs.trykintsugi.com/reference/2026-07-21/approve-a-filing

POST /filings/{filing_id}/approve

Approve a filing

Approve a filing, moving it into the FILING lifecycle and locking its transactions. Requires an ADMIN or OWNER credential; send an `Organization-Id`, `Connection-Id` or `Entity-Id` selector to say which organization it belongs to. Approving a BACK_FILING with published terms requires `backFilingTermsId`. Pass `autoFile: true` to also turn on the organization's auto-file setting as part of the approval (applied only after it succeeds); omit it to leave the setting unchanged.

Approving a filing that is not UNFILED or PAUSED is a no-op and returns the filing unchanged. Returns 404 if the filing does not exist or belongs to an organization your credential cannot access, 403 if its jurisdiction is not enabled, 403 PLAN_UPGRADE_REQUIRED when the organization is on a free plan, 403 FORBIDDEN when the organization's plan does not include managed filings, and 409 if a filing already exists for the period.

Category: Filings

Path parameters:
filing_id (string, required) - The unique identifier of the filing.

Request body:
backFilingTermsId (string) - Id of the back-filing terms version the customer accepted, if any.
backFilingTermsAcceptedAt (string) - When the customer accepted the back-filing terms (advisory).
requestId (string) - Client-minted id for this confirm attempt, stored on the audit row so a double-submit or retry of one gesture can be collapsed by readers.
autoFile (boolean) - When true, also turn on the organization's auto-file setting as part of the approval, so future returns file automatically. Applied only after the approval succeeds; omit, null or false leaves the setting unchanged. No effect for organizations on the new auto-filing experience.

Response fields:
id (string, required) - Kintsugi's unique identifier for the filing.
organizationId (string, required) - Organization the filing belongs to.
organizationName (string) - Display name of the organization the filing belongs to. `null` when the organization has no name set.
registrationId (string) - The registration this filing period is filed under, if any.
status (PublicFilingStatusEnum, required) - Lifecycle status of the filing.
  allowed values: UNFILED, FILED, FILING, PAUSED, SKIPPED, CANCELLED, ISSUE
[truncated, see the reference page]

---

Index of every page: https://docs.trykintsugi.com/llms.txt