# Get filings

> GET /v1/filings

Source: https://docs.trykintsugi.com/reference/get-filings

API version: v1 (legacy API)

GET /v1/filings

Get filings

The Get Filings API retrieves a paginated list of filings based on
    filters such as dates, jurisdiction, Country, status, etc. This helps track
    and manage tax filings efficiently across multiple jurisdictions.

Category: Filings

Query parameters:
status__in (string) - Filter filings by status
  allowed values: FILED, FILING, SUBMITTED, UNFILED, PAUSED, CANCELLED, ISSUE, SKIPPED
start_date (string) - Filter filings with a start date greater than or equal to this date.
end_date (string) - Filter filings with an end date less than or equal to this date.
date_filed__gte (string) - Filter filings filed on or after this date.
date_filed__lte (string) - Filter filings filed on or before this date.
order_by (string) - Comma-separated list of fields to sort the results.
  allowed values: status, start_date, end_date, amount
state_code (string) - Filter filings by state code (e.g., CA for California).
country_code (CountryCodeEnum | string[]) - Filter filings by country code in ISO 3166-1 alpha-2 format (e.g., US).
  allowed values: AF, AX, AL, DZ, AS, AD, AO, AI, AQ, AG, AR, AM (and 239 more, see the reference page)
filing_category__in (string) - Filter filings by category (e.g., REGULAR, BACK_FILING, AMENDMENT).
tax_type__in (string) - Filter filings by tax type. Multiple tax types can be
        passed, separated by commas (SALES_TAX, USE_TAX, SALES_AND_USE_TAX).
  allowed values: SALES_TAX, USE_TAX
page (integer) - Page number
size (integer) - Page size

Response fields:
items (FilingRead[], required)
  status (FilingStatusEnum) - Filing status. Possible values:
                                    UNFILED, FILING, SUBMITTED, FILED, PAUSED, SKIPPED, CANCELLED, ISSUE.
    allowed values: UNFILED, FILED, FILING, SUBMITTED, PAUSED, SKIPPED, CANCELLED, ISSUE
  start_date (string, required) - The start date of the filing period.
  end_date (string, required) - The end date of the filing period.
  due_date (string) - The due date of the filing.
  date_filed (string) - The date the filing was completed, if applicable.
  is_manual (boolean) - Indicates if the filing was done manually.
  state_code (string) - The code of the state associated with the filing (e.g., IA, NY).
  state_name (string) - The name of the state associated with the filing
        (e.g., Iowa, New York).
[truncated, see the reference page]

---

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