Adding Submitted Status Value to the Filing API

We are introducing a new submitted status to the Filing API that provides visibility into filings that have been sent to the agency but are not yet accepted. This will be available in Sandbox on March 16th and will merge to production on March 30th.

What is changing:

• The Filing API now supports five statuses: inapplicable, pending, blocked, submitted, and filed
• The new submitted status indicates a filing has been sent to the tax agency and is awaiting processing. The definitions of the other statuses are unchanged.
• The filing date (when a filing was submitted to the agency) is available via the status_history array. Use the most recent entry where status = "submitted" and read its status_at value. We recommend labeling this as "Filing Date" in your UI.
• filed_at continues to represent when the agency accepted the filing

What you need to do:

• If you filter by status: Add submitted to your recognized statuses
• If you display filing status: Add a display treatment for submitted
• If you display a filing date: Use status_history to extract the submitted date (see API documentation below)