Skip to main content

Data Dictionary

Field definitions for Gryd datasets, including permit, property, contractor, license, project, and jurisdiction data. Field availability, coverage, and detail may vary by source, jurisdiction, dataset, and access method.

Browse fields by dataset category.

Select a dataset below to view available fields, data types, and descriptions.

Permit Fields

[ 380M+ building permits across 2,500+ jurisdictions ]

№
Field Name
Description
Originator
Null Values*

Sample

Type
Length
 
buildingPermitId
The unique BuildZoom identifier assigned to each building permit. This is a case-sensitive alphanumeric value.
BuildZoom
No

xxYo7g3

VARCHAR
100
 
propertyId
The unique BuildZoom identifier assigned to each property. This is a case-sensitive alphanumeric value.
BuildZoom
No

asZo3e1

VARCHAR
100
 
projectOwner
The name of the home owner or the person the work is for as specified on the permit.
Building Permit
Minimal

Brian Waltmann

VARCHAR
100
 
street
The property's street address.
BuildZoom
Minimal

115 Dottie Ln

VARCHAR
100
 
city
The property's city.
BuildZoom
Minimal

Alpharetta

VARCHAR
100
 
state
The property's state.
BuildZoom
Minimal

GA

VARCHAR
100
 
zipCode
The property's 5-digit zip code.
BuildZoom
Minimal

30004

VARCHAR
100
 
parcelNumber
The parcel number of the relevant property as reported on the building permit.
Building Permit
High

5738-005-061

VARCHAR
100
 
countyName
The property's CBSA (Core-based statistical area).
BuildZoom
Minimal

Orange County

VARCHAR
225
 
countyFips
The property's county_fips code.
BuildZoom
Minimal

12011

VARCHAR
100
 
cbsaName
The property's county.
BuildZoom
Minimal

Los Angeles-Long Beach-Anaheim, CA

VARCHAR
225
 
cbsaFips
The property's cbsa_fips code.
BuildZoom
Minimal

12011

VARCHAR
100
 
propertySector
Ex: commercial, residential, public works, industrial, etc.
Various
Minimal

commercial

VARCHAR
100
 
propertyType
Ex: single family, multifamily, retail, office, etc.
Various
Minimal

retail

VARCHAR
100
 
permitJurisdiction
The government source for this building permit with format [state_county_city]. The city and county may be omitted for county-level and state-level jurisdictions.
BuildZoom
No

CA_Los Angeles_Los Angeles

VARCHAR
225
 
permitNumber
The official permit number as given by the issuing body.
Building Permit
Minimal

B090159

VARCHAR
100
 
description
The description of work requiring the permit as specified by the project owner on the permit.
Building Permit
Minimal

Addition roof over existing front porch stoop

TEXT
 
projectName
The project title for the permit as specified by the project owner on the permit.
Building Permit
Minimal

BLD2015-01250

TEXT
 
rawType
The category or type of work the permit is for as specified by the permit. Values vary by jurisdiction.
Building Permit
Moderate

New_bldg ba: res-addition/alteration

VARCHAR
100
 
rawSubtype
The subtype of work the permit is for as specified by the permit. Values vary by jurisdiction.
Building Permit
Moderate

Roofing

VARCHAR
100
 
jobValue
The job value estimate provided by the contractor on the permit. This value is provided prior to the start of work.
Building Permit
Moderate

1680

DECIMAL
32,2
 
fees
The building permit fees paid to the presiding building permit authority. In absence of a declared job value, the fees are a reasonable, directional estimate to the size and scale of a project.
Building Permit
Moderate

52

VARCHAR
100
 
units
The number of units in the relevant structure/property as reported on the building permit.
Building Permit
High

31

VARCHAR
100
 
stories
The number of stories in the relevant structure as reported on the building permit.
Building Permit
High

2

VARCHAR
100
 
squareFeet
The estimated square feet of the project as reported on the building permit.
Building Permit
High

9240

VARCHAR
100
 
applicant
The name of the construction company that submitted the building permit.
Building Permit
Minimal

Atlanta Decking & Fence Company, Inc

VARCHAR
100
 
projectTypes
The normalized description of service performed, specified by BuildZoom's proprietary classification method.
BuildZoom
Minimal

Roofing

VARCHAR / JSON
100
 
initialStatusDate
The date of the permit's first known stage in the building and approval process. These stages vary by jurisdiction.
Building Permit
Minimal

2019-01-01

DATE
 
initialStatus
The permit's first known stage in the building and approval process. These stages vary by jurisdiction.
Building Permit
Minimal

applied

VARCHAR
100
 
latestStatusDate
The date of the permit's last known stage in the building and approval process. These stages vary by jurisdiction.
Building Permit
Minimal

2019-01-04

DATE
 
latestStatus
The permit's last known stage in the building and approval process. These stages vary by jurisdiction.
Building Permit
Minimal

completed

VARCHAR
100
 
appliedDate
The date on which the permit application was officially received and documented by the jurisdiction
Building Permit
Minimal

2019-01-01

DATE
 
issuedDate
The date on which the permit was formally granted, approved, or released by the jurisdiction
Building Permit
Minimal

2019-01-02

DATE
 
completedDate
The date on which the project has been finished, finalized, or successfully accomplished
Building Permit
Minimal

2019-01-03

DATE
 
canceledDate
The date on which the permit was officially terminated or annulled
Building Permit
Minimal

2019-01-04

DATE
 
permitStatuses
The normalized stage of the permit in the building and approval process. These stages vary by jurisdiction. The output lists statuses and their corresponding order.
BuildZoom
Minimal

Issued

VARCHAR / JSON
100
 
contractorId
The unique proprietary identifier assigned by BuildZoom to each Contractor entity. The Contractor entity's Building Permit entity matches are reconciled onto this identifier. This is a case-sensitive alphanumeric value.
BuildZoom
Moderate

xxYo7g3

VARCHAR
100
 
contractorPhone
The contractor's phone number
Various
Moderate

2125553189

‍

VARCHAR
255
 
contractorEmail
The contractor's email address
Various
Moderate

abc@abc.com

VARCHAR
100
№
Field Name
Description
Originator
Null Values*

Sample

Type
Length
 
contractorId
The unique proprietary identifier assigned by BuildZoom to each Contractor entity. The Contractor entity's Building Permit entity matches are reconciled onto this identifier. This is a case-sensitive alphanumeric value.
BuildZoom
No

xxYo7g3

VARCHAR
100
 
businessName
The legal entity name of the licensed contractor or construction company
Contractor License
No

Atlanta Decking & Fence Co Inc

VARCHAR
255
 
contractorType
The contractor's primary classification, classified by BuildZoom. This is the type of work they primarily do
BuildZoom
Minimal

General Contractor

VARCHAR
100
 
buildzoomProfileSlug
The url that helps you navigate to the BuildZoom public profile. Pre-pend with the BuildZoom domain as in this example: "https://buildzoom.com/contractor/{url}".
BuildZoom
Minimal

aaa-construction

VARCHAR
255
 
website
The contractor's business website
Various
Moderate

http://www.freshcoatrestoration.com/

VARCHAR
255
 
email
The contractor's email address
Various
Moderate

abc@abc.com

VARCHAR
100
 
phoneNumber
The contractor's phone number
Contractor License
Moderate

2125553189

VARCHAR
255
 
employeeNames
The names of contractor's employees
Contractor License
Moderate

John Smith

VARCHAR
100
 
hqStreet
The contractor's street address
Contractor License
Minimal

200 Santa Monica Pier, Santa Monica, CA 90401

VARCHAR
100
 
hqCity
The contractor's city
Contractor License
Minimal

Santa Monica

VARCHAR
100
 
hqState
The contractor's state
Contractor License
Minimal

CA

VARCHAR
100
 
hqZipCode
The contractor's 5-digit zip code.
Contractor License
Minimal

90401

VARCHAR
100
 
latitude
The contractor's geographical latitude.
BuildZoom
Minimal

34,095604

DECIMAL
9,6
 
longitude
The contractor's geographical longitude.
BuildZoom
Minimal

-84,286858

DECIMAL
9,6
 
latestLicenseNumber
The contractor's license number(s). Contractors may have multiple licenses. Each license will have it's own row
Contractor License
Minimal

RBCO001910

VARCHAR
255
 
latestLicenseDescription
The contractor's license description(s).
Contractor License
Minimal

Residential/General Contractor

VARCHAR
255
 
latestLicenseState
The state that the license is valid in.
Contractor License
Minimal

CA

VARCHAR
100
 
latestLicenseIssuer
The issuing body of the license.
Contractor License
Minimal

Commonwealth of Massachusetts E-Licensing Board

VARCHAR
255
 
hasVerifiedLicense
A boolean indicator, representing whether a contractor currently possesses at least one verified active license
BuildZoom
Minimal

1

INT
1
 
permitCountAllTime
Count of all permits associated with this contractor.
BuildZoom
Moderate

25

INT
18
 
permitCountT4y
Count of this contractor's permits from the prior 4 years.
BuildZoom
Moderate

5

INT
18
 
earliestPermitDate
The earliest date from permits associated with this contractor.
BuildZoom
Moderate

1995-03-15

DATE
 
latestPermitDate
The latest date from permits associated with this contractor.
BuildZoom
Moderate

2024-02-21

DATE
 
typicalJobValue (Coming Soon)
Estimated dollar value of the kinds of jobs this contractor typically works on.
BuildZoom
Moderate

75.000,00

DECIMAL
32,2

Data Dictionary FAQs.

№

Question

Answer

What is the Gryd Data Dictionary?

The Data Dictionary is a field-by-field reference for Gryd's construction data, covering permits, properties, contractors, licenses, and projects, so teams can see exactly what data is available and how it's structured before working with it.

What datasets are included in the dictionary?

Permit data can show documented construction activity, such as roof work, renovations, additions, solar installs, HVAC updates, electrical work, plumbing work, and other property improvements.

What datasets are included in the dictionary?

Five core record types: permits, properties, contractors, licenses, and projects. Each dataset lists its available fields, data types, and descriptions.

Is every field available for every record?

Field availability depends on what each source jurisdiction reports and captures. Some fields, such as job value, finalized date, and license status, are only present where the issuing authority provides them.

Why do field formats vary?

Local jurisdictions report data differently. Gryd standardizes formatting wherever possible, but some fields retain their original source formatting to preserve accuracy.

Does the Data Dictionary apply to all three access paths?

Yes. The same fields and structure apply whether you access data through the Explorer platform, API, or Bulk Data. Availability may vary by dataset and jurisdiction, not by access method.

Need help understanding which fields matter for your use case?

Tell us what your team is trying to understand, verify, monitor, model, or build. We’ll help point you toward the right data and access path.