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.
Authorization
Headers
Release date, as YYYY-MM-DD. Defaults to 2026-07-21.
Narrow the request to one organization (Organization-Id selector).
Narrow the request to a connection's organization.
Narrow the request to a platform entity's organization.
Optional source to disambiguate an Entity-Id.
Query
Every query parameter below is optional. Combine as many as you need and append them to the endpoint as a query string. The example shows a few to get you started.
/filings?expand=<expand>&limit=<limit>&cursor=<cursor>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.
salesBreakdownvatRecoveryartifactsMaximum number of items to return.
Opaque cursor from a prior response's nextCursor or previousCursor. Omit for the first page.
Field to sort by. Omit to keep the default (id-ordered) ordering.
statuscountryCodestateCodestartDateendDatedateFiledamounttotalTaxLiabilitySort direction. Applies only when sort is set. Defaults to asc.
ascdescComma-separated lifecycle statuses; matches any of them.
Comma-separated ISO 3166-1 alpha-2 country codes; matches any.
Comma-separated state/province codes; matches any.
Comma-separated filing categories; matches any.
Comma-separated tax types; matches any.
Only filings filed under this registration.
Only filings whose period starts on/after.
Only filings whose period ends on/after.
Only filings whose period ends on/before.
Only filings filed on/after.
Only filings filed on/before.
Response
The filings on this page.
Opaque cursor for the next page. null when this is the last page. Send it back as cursor; do not parse it.
Opaque cursor for the previous page. null when this is the first page. Send it back as cursor; do not parse it.
Whether a page exists after this one.
Whether a page exists before this one.
Successful Response
The request was invalid.
Authentication failed or was missing.
The credential is not permitted for this request.
The requested resource was not found.
The request conflicts with existing state.
The request failed validation.