# Get a filing by id

> GET /filings/{filing_id}

Source: https://docs.trykintsugi.com/reference/2026-07-21/get-a-filing-by-id

GET /filings/{filing_id}

Get a filing by id

Fetch a single filing by id. Searched across every organization your credential owns, so no selector is needed for a known id. Pass `expand=salesBreakdown`, `expand=vatRecovery` and/or `expand=artifacts` to embed those buckets; omitted otherwise. Returns 404 if the filing does not exist or belongs to an organization your credential cannot access.

Category: Filings

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

Query parameters:
expand (FilingExpand[]) - Buckets to embed on the filing. `salesBreakdown` embeds the period's sales composition; `vatRecovery` embeds the EU/UK input-VAT recovery rate pair; `artifacts` embeds the filing's return/payment/additional artifacts by slot. Omitted otherwise.
  allowed values: salesBreakdown, vatRecovery, artifacts

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.
endDate (string, required) - Last day of the filing period, as YYYY-MM-DD.
dueDate (string) - When the return is due, as YYYY-MM-DD.
dateFiled (string) - When the return was filed, as YYYY-MM-DD; null until filed.
returnConfirmationId (string) - Return confirmation id from the jurisdiction portal; null until filed.
[truncated, see the reference page]

---

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