---
title: "Changes to Get filings"
method: GET
path: "/v1/filings"
---

# Changes to Get filings

`GET /v1/filings`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 10 of 37 revisions.

- **2026-10-28** `2c90b14ca671`: 1 warning
- **2026-10-09** `47ea0598da9f`: 1 warning
- **2026-10-08** `4d133b803912`: 1 breaking, 1 warning
- **2026-09-24** `460fe06a9b8b`: 1 warning, 1 info
- **2026-09-16** `43e9b1f94e5c`: 2 info
- **2026-09-15** `bd1bad0a9967`: 3 info
- **2026-09-08** `5867a9a6b421`: 1 info
- **2026-09-05** `d3267968928c`: 1 info
- **2026-09-02** `846cc8ce4d30`: 1 info
- **2026-08-29** `6ba4f4c774c3`: 19 breaking, 4 warning, 208 info

## Changes

- **2026-10-28** `2c90b14ca671`: 1 warning
  - added the new `SMALL_PARCEL_VAT` enum value to the `items/items/tax_type` response property for the response status `200`
- **2026-10-09** `47ea0598da9f`: 1 warning
  - removed the optional property `items/items/is_rdf` from the response with the `200` status
- **2026-10-08** `4d133b803912`: 1 breaking, 1 warning
  - for the `query` request parameter `status__in`, default value was changed from `FILED,FILING,UNFILED,PAUSED,CANCELLED,ISSUE,SKIPPED` to `FILED,FILING,SUBMITTED,UNFILED,PAUSED,CANCELLED,ISSUE,SKIPPED`
  - added the new `SUBMITTED` enum value to the `items/items/status` response property for the response status `200`
- **2026-09-24** `460fe06a9b8b`: 1 warning, 1 info
  - added the new `RETAIL_DELIVERY_FEE` enum value to the `items/items/tax_type` response property for the response status `200`
  - added the optional property `items/items/fee_type` to the response with the `200` status
- **2026-09-16** `43e9b1f94e5c`: 2 info
  - added the optional property `items/items/amount_input_vat_recoverable_base` to the response with the `200` status
  - added the optional property `items/items/input_vat_recovery_rate_applied` to the response with the `200` status
- **2026-09-15** `bd1bad0a9967`: 3 info
  - added the optional property `items/items/amount_input_vat_true_up` to the response with the `200` status
  - added the optional property `items/items/submitted_payment_confirmation_id` to the response with the `200` status
  - added the optional property `items/items/submitted_return_confirmation_id` to the response with the `200` status
- **2026-09-08** `5867a9a6b421`: 1 info
  - added the optional property `items/items/is_final` to the response with the `200` status
- **2026-09-05** `d3267968928c`: 1 info
  - added the optional property `items/items/amount_input_vat_recoverable` to the response with the `200` status
- **2026-09-02** `846cc8ce4d30`: 1 info
  - added the optional property `items/items/assistance_ticket_id` to the response with the `200` status
- **2026-08-29** `6ba4f4c774c3`: 19 breaking, 4 warning, 208 info
  - added the new required `header` request parameter `x-organization-id`
  - for the `query` request parameter `status__in`, default value was changed from `FILED,FILING,UNFILED,PAUSED` to `FILED,FILING,UNFILED,PAUSED,CANCELLED,ISSUE,SKIPPED`
  - response property `items/items/approved_at` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `items/items/approved_by` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `items/items/auto_approved` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `items/items/block_approval` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `items/items/date_filed` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `items/items/due_date` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `items/items/filing_website_url` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `items/items/internal_notes` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `items/items/is_manual` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `items/items/paused_until_date` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `items/items/payment_confirmation_id` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `items/items/recent_details_report_link` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `items/items/return_confirmation_id` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `items/items/state_code` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `items/items/state_name` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `items/items/total_taxable_sales` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - the `items/items/currency` response's property type changed from `string` to no type for status `200`
  - removed the optional property `items/items/jira_issue_key` from the response with the `200` status
  - added the new `CANCELLED` enum value to the `items/items/status` response property for the response status `200`
  - added the new `ISSUE` enum value to the `items/items/status` response property for the response status `200`
  - added the new `SKIPPED` enum value to the `items/items/status` response property for the response status `200`
  - the endpoint scheme security `APIKeyHeader` was added to the API
  - the endpoint scheme security `APIKeyHeader AND CustomHeader` was removed from the API
  - added the new optional `query` request parameter `filing_category__in`
  - added the new optional `query` request parameter `tax_type__in`
  - `query` request parameter `country_code` list-of-types was widened by adding types `null`
  - `query` request parameter `date_filed__gte` list-of-types was widened by adding types `null`
  - `query` request parameter `date_filed__lte` list-of-types was widened by adding types `null`
  - `query` request parameter `end_date` list-of-types was widened by adding types `null`
  - `query` request parameter `order_by` list-of-types was widened by adding types `null`
  - `query` request parameter `start_date` list-of-types was widened by adding types `null`
  - `query` request parameter `state_code` list-of-types was widened by adding types `null`
  - `query` request parameter `status__in` list-of-types was widened by adding types `null`
  - for the `query` request parameter `country_code`, the type was generalized from `array` to no type
  - for the `query` request parameter `date_filed__gte`, the type was generalized from `string` to no type
  - for the `query` request parameter `date_filed__lte`, the type was generalized from `string` to no type
  - for the `query` request parameter `end_date`, the type was generalized from `string` to no type
  - for the `query` request parameter `order_by`, the type was generalized from `string` to no type
  - …191 more
  - …this revision’s changelog is incomplete

---

[Operation](https://skmtc.dev/trykintsugi/apis/tax-platform/docs/v1/filings/get.md) - [API](https://skmtc.dev/trykintsugi/apis/tax-platform.md) - [Page](https://skmtc.dev/trykintsugi/apis/tax-platform/changes/v1/filings/get)
