# List filings

> GET /filings

Source: https://docs.trykintsugi.com/reference/2026-07-21/list-filings

GET /filings

List filings

List filings, keyset-paginated. Covers every organization your credential owns; send an `Organization-Id`, `Connection-Id` or `Entity-Id` selector to narrow to one. Every list filter takes a comma-separated list and matches any of the values you send. Pass `limit` and the opaque `cursor` from a prior response's `nextCursor`/`previousCursor` to page. Pass `sort` and `order` to order the list; omit `sort` to keep the default order. None of the sort keys is index-backed, so sorting a large scope sorts the whole matching set. Pass `expand=salesBreakdown`, `expand=vatRecovery` and/or `expand=artifacts` to embed those buckets on each row; omitted otherwise. A cursor is only valid for the sort, the filters AND the organization scope it was issued under; change any of them and start again from the first page. `expand` does not affect which filings are returned, so a cursor stays valid whether or not you pass it. Filings marked do-not-file (skipped under an organization or registration do-not-file setting) are excluded from this list and from the summary counts.

Category: Filings

Query parameters:
expand (FilingExpand[]) - Buckets to embed on each 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. Does not change which filings are returned.
  allowed values: salesBreakdown, vatRecovery, artifacts
limit (integer) - Maximum number of items to return.
cursor (string) - Opaque cursor from a prior response's nextCursor or previousCursor. Omit for the first page.
sort (PublicFilingSortEnum) - Field to sort by. Omit to keep the default (id-ordered) ordering.
  allowed values: status, countryCode, stateCode, startDate, endDate, dateFiled, amount, totalTaxLiability
order (PublicFilingSortOrder) - Sort direction. Applies only when `sort` is set. Defaults to `asc`.
  allowed values: asc, desc
status (string) - Comma-separated lifecycle statuses; matches any of them.
countryCode (string) - Comma-separated ISO 3166-1 alpha-2 country codes; matches any.
stateCode (string) - Comma-separated state/province codes; matches any.
filingCategory (string) - Comma-separated filing categories; matches any.
taxType (string) - Comma-separated tax types; matches any.
[truncated, see the reference page]

---

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