# Pause a filing

> POST /filings/{filing_id}/pause

Source: https://docs.trykintsugi.com/reference/2026-10-06/pause-a-filing

POST /filings/{filing_id}/pause

Pause a filing

Pause a filing. Requires an ADMIN or OWNER credential; send an `Organization-Id`, `Connection-Id` or `Entity-Id` selector to say which organization it belongs to. `pauseIntent` says why: `review` auto-resumes on `pausedUntilDate` (which is then required), `assistance` pauses indefinitely for manual help, and `skip` skips the period.

Returns 404 if the filing does not exist or belongs to an organization your credential cannot access, and 400 if the filing cannot be paused in its current state or the request is invalid for the chosen intent.

Category: Filings

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

Request body:
pauseIntent (PublicPauseIntentEnum, required) - Why the filing is being paused.
  allowed values: review, assistance, skip
pausedUntilDate (string) - Date a `review` pause auto-resumes, as YYYY-MM-DD, from today to the 15th of the month the filing is due. Required for `review`; ignored for `assistance` and `skip`.
pauseReason (string) - Optional text explaining why the filing is paused. A reason too long for the filing note is rejected with 400.
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.

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, SUBMITTED, PAUSED, SKIPPED, CANCELLED, ISSUE
filingCategory (string, required) - The kind of filing period: REGULAR, AMENDMENT or BACK_FILING (a legacy PREPAYMENT value may appear on historical rows).
taxType (PublicTaxTypeEnum, required) - Which taxes this filing covers, from the associated registration.
  allowed values: SALES_TAX, USE_TAX, SALES_AND_USE_TAX, RETAIL_DELIVERY_FEE
countryCode (string, required) - ISO 3166-1 alpha-2 country code of the filing jurisdiction, such as `US`, `CA` or `GB`.
[truncated, see the reference page]

---

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