Permit Status Details
Understanding Shovels Permit Statuses
In the context of permit tracking, various statuses are used to indicate the lifecycle and progress of a permit from filing to completion or discontinuation. Common permit statuses include "in_review," "active," "final," and "inactive." These statuses help users understand where a permit stands in the overall process. These statuses follow a chronological progression in most cases.
In the Shovels ecosystem, there are four statuses that permits can be in:
in_review: From the moment the permit is filed with the local jurisdiction, until it is approved. This is defined by thefile_dateobject.active: From the moment the permit is approved, until project completion or some other intermediate restriction. This is defined by theissue_dateobject.final: When the permit is completed, and submitted back to the jurisdiction upon job completion. This is defined by thefinal_dateobject.inactive: If any part of the process stalls or gets restricted from progression, then the permit status moves toinactive. Disqualifying reasons and reporting time will vary by jurisdiction and local regulation, but can include failing to meet project inspections, the permit may expire before completion or inactivity for more than 6 months (180 days), and many others.
Sometimes there are "unknown" and "none" permit statuses. There are various reasons this can happen, including variances in jurisdiction record keeping, lack of data, dates not provided, and more. The exact meanings of these statuses can vary depending on the context or jurisdiction in which they are used.
For more information on Shovels permit statuses, read Shovels 101: Permit Statuses