> ## Documentation Index
> Fetch the complete documentation index at: https://docs.shovels.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Permit Data Downloads

> Learn what data fields are included in Shovels permit downloads, including permit details, timelines, property characteristics, and geographic information.

Shovels permit record downloads include 40 data fields covering permit details, timelines, property characteristics, and geographic information.

<Card title="Download a Sample" icon="download" href="https://48146409.fs1.hubspotusercontent-na1.net/hubfs/48146409/permits_download_sample.csv">
  See a sample permit download CSV file
</Card>

## What's Included

Each record represents a single permit application with detailed information spanning the entire permit lifecycle, property characteristics, and geographic identifiers.

### Permit Information

Core permit details including:

* Unique identifiers
* Descriptions
* Permit numbers
* Jurisdictions
* Job values
* Types and subtypes
* Associated fees
* Current status

### Timeline and Duration

Comprehensive date fields capturing the permit journey:

* File date
* Issue date
* Final date
* Start date
* End date

Duration metrics track:

* Total project time
* Construction phases
* Approval processes
* Inspection pass rates

### Location and Property Details

**Geographic data:**

* Street addresses
* Cities and counties
* ZIP codes
* Latitude/longitude coordinates
* Census tracts
* Congressional districts

**Property characteristics:**

* Ownership information
* Assessed market values
* Lot sizes
* Building areas
* Story counts
* Unit counts
* Year built

### Additional Metadata

* Contractor IDs for tracking key industry players
* Tags for flexible categorization and filtering

## How to Download

1. Run your permit search in Shovels Online
2. Apply desired filters
3. Click the download button
4. Select CSV format

<Info>
  **Exports cover the full set of matching records.** There is no per-export record cap, so you do not need to split a large search into smaller queries. Each exported record spends one credit—check your remaining balance before exporting a large result set.
</Info>

<Info>
  CSV export requires a paid plan; the export action is unavailable on the Free plan. Retrieving records through the API is metered the same way, one credit per record.
</Info>

## Related Articles

* [Contractor downloads](/docs/knowledge-base/shovels-online/contractor-downloads)
* [Filters and sorting](/docs/knowledge-base/shovels-online/filters-and-sorting)
* [Data Dictionary](/docs/data-dictionary-online)