> ## 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

<Warning>
  **Download limit:** For performance reasons, Shovels Online limits downloads to **1,000 records** per search. To export more records, break your query into smaller segments (e.g., filter by city instead of state) and run each separately.
</Warning>

<Info>
  CSV downloads are available to paying customers. Trial accounts have limited download access. The API has no result limits for programmatic access.
</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)