# Pause a filing

> POST /filings/{filing_id}/pause

Source: https://docs.trykintsugi.com/reference/2026-07-21/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. Required for `review`; ignored for `assistance` and `skip`.
pauseReason (string) - Optional customer-supplied reason for the pause.
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, 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.
stateCode (string) - State or province code, or '' for a country-level filing.
stateName (string) - Human-readable jurisdiction name.
startDate (string, required) - First day of the filing period, as YYYY-MM-DD.
[truncated, see the reference page]

---

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