# Data dictionary

Every field on a Boardwalk project record: what it means, its type, and a real example. Examples are from one real project, Torrington Creekside, Mesquite, TX (record 10933940, read 2026-10-14), with people's names left out. If the filing doesn't state a detail, the field stays empty. Every field's full contract: [API docs](https://boardwalkai.com/docs/api/fields/).

Data as of Oct 11, 2026. Page: https://boardwalkai.com/data-dictionary/

## Identity

| Field | API name | Type | What it means | Example |
|---|---|---|---|---|
| Project ID | `id` | integer | Boardwalk's permanent ID for the project. | `10933940` |
| Record Type | `recordType` | string | The kind of record, always a project for now. | `"project"` |
| Project Name | `projectName` | string | The project's name. | `"Torrington Creekside"` |
| Boardwalk Link | `boardwalkLink` | string | A link that opens the project on the Boardwalk map. | `"https://boardwalkai.com/map/#project=10933940"` |
| Merged From | `mergedFrom` | array | IDs of duplicate filings merged into this one project. | `[10933940]` |
| Last Updated | `lastUpdated` | string (nullable) | When the record last changed. | `"2026-07-19T17:37:50Z"` |
| Meeting Date | `meetingDate` | string (nullable) | The date of the latest public meeting that took up the project. | `"2026-09-08"` |
| What's Happening | `projectHeadline` | string (nullable) | One line on the latest news about the project. | `"291-Unit Residential Development by JPI Development"` |

## Delivery

| Field | API name | Type | What it means | Example |
|---|---|---|---|---|
| Delivery State | `delivery` | object (nullable) | Whether this record was already delivered to you, and whether it was billed. | `{ "alreadyExported": true, "updatedSinceExport": false, "billed": false }` |

## Location

| Field | API name | Type | What it means | Example |
|---|---|---|---|---|
| Address | `address` | string (nullable) | The street address, as written in the filing. | `"900 and 1000 Windbell Circle"` |
| City | `city` | string (nullable) | The city the project is in. | `"Mesquite"` |
| County | `county` | string (nullable) | The county the project is in. | `"Dallas"` |
| State | `state` | string (nullable) | The two-letter state code. | `"TX"` |
| Latitude | `latitude` | number (nullable) | Latitude of the project on the map. | `32.777988828667` |
| Longitude | `longitude` | number (nullable) | Longitude of the project on the map. | `-96.622528458401` |
| In Opportunity Zone | `inOpportunityZone` | boolean (nullable) | Whether the site is in a federal Opportunity Zone. | `false` |
| In FEMA Flood Zone | `inFemaFloodZone` | boolean (nullable) | Whether the site is in a FEMA flood zone. | `false` |
| ZIP | `postalCode` | string (nullable) | The ZIP code of the main address. | `null` |
| Location Precision | `locationPrecision`, `locationPrecisionLabel` | string (nullable) | How precisely the project is placed, from street address to county. | `"address"` |
| Approximate Location | `isApproximate` | boolean | Yes when the map point is estimated rather than taken from an address. | `false` |
| Parcel / APN | `parcelApn` | array | Assessor parcel numbers named in the filing. | `[]` |
| State ID | `stateId` | integer (nullable) | Boardwalk's ID for the state. | `95` |
| County ID | `countyId` | integer (nullable) | Boardwalk's ID for the county. | `5755` |
| City ID | `cityId` | integer (nullable) | Boardwalk's ID for the city. | `59845` |
| Additional Addresses | `additionalAddresses` | array | Other addresses tied to the project. | `[{ "address": "900 and 1000 Windbell Circle", "city": "Mesquite", "state": "TX", … }]` |

## Classification

| Field | API name | Type | What it means | Example |
|---|---|---|---|---|
| Property Type | `propertyType`, `propertyTypeLabel` | string (nullable) | The main land use, such as residential. | `"Residential"` |
| Land Uses | `landUses` | array | Every land use in the project, like homes and shops. | `[{ "type": "Residential", "subtype": "Multifamily", "assetClass": "Apartment Building", … }]` |
| Property Subtype | `propertySubtype`, `propertySubtypeLabel` | string (nullable) | The land use one level down, such as multifamily. | `"Multifamily"` |
| Asset Class | `assetClass`, `assetClassLabel` | string (nullable) | The most specific land use, such as apartments. | `"Apartment Building"` |
| Lead Type | `leadType`, `leadTypeLabel` | string (nullable) | Private or public project, and whether it is a small job. | `"private"` |
| Project Stage | `stage`, `stageLabel` | string (nullable) | Where the project is in its life, from concept to complete. | `"entitlement"` |
| All Classifications | `classifications` | array | Every land-use label on the project, main and secondary. | `[{ "role": "primary", "type": "Residential", … }, { "role": "secondary", "type": "Govt. Decisions", … }]` |
| Tags | `tags` | array | Free-form tags on the project. | `[]` |

## Status

| Field | API name | Type | What it means | Example |
|---|---|---|---|---|
| Current Status | `status`, `statusLabel` | string (nullable) | The latest outcome, such as approved or pending. | `"recommended_for_approval"` |
| Status Summary | `statusSummary` | string (nullable) | One sentence on where the project stands. | `"The City of Mesquite City Council approved Ordinance No. 5230 to amend the Planned Development zoning for the Torrington Creekside project."` |
| Request Type | `requestType`, `requestTypeLabel` | string (nullable) | What the applicant asked for, such as a rezoning. | `"rezone"` |
| Decision Body | `decisionBody` | string (nullable) | The board that heard the request, such as the planning commission. | `"Mesquite Planning and Zoning Commission"` |
| Case Number | `caseNumbers` | array | Case numbers the city or county assigned. | `["Z1225-0433"]` |
| Is Appeal | `isAppeal` | boolean (nullable) | Yes when the hearing is an appeal. | `false` |
| Next Hearing Date | `nextHearingDate` | string (nullable) | The next scheduled hearing, when the filing gives one. | `null` |

## Site

| Field | API name | Type | What it means | Example |
|---|---|---|---|---|
| Acreage | `acreage` | number (nullable), acres | Site size in acres. | `12` |
| Square Footage | `squareFootage` | number (nullable), sqft | Total building floor area in square feet. | `99992` |
| Unit Mix | `unitMix` | array | Homes or spaces, counted by type. | `[{ "count": 53, "type": "apartment" }, { "count": 152, … }, { "count": 86, … }]` |
| Total Units | `totalUnitCount` | integer (nullable) | Total dwelling units. | `291` |
| Bedrooms | `bedroomCount` | integer (nullable) | Total bedrooms. | `615` |
| Stories | `buildingStories` | integer (nullable) | Number of stories. | `4` |
| Floor Count | `floorCount` | integer (nullable) | The most floors above ground in any stated building. | `4` |
| Building Height | `buildingHeightFeet` | number (nullable), feet | Building height in feet. | `null` |
| Parking Spaces | `parkingSpaces` | integer (nullable) | Parking spaces proposed. | `null` |
| Affordable Units | `affordableUnits` | integer (nullable) | Units set aside as affordable. | `null` |
| Lot Count | `lotCount` | integer (nullable) | Lots in the subdivision or plat, not counting open space. | `null` |
| Building Count | `buildingCount` | integer (nullable) | Number of buildings proposed. | `1` |
| Amenities | `amenities` | array | Amenities named in the filing, such as a pool. | `["pool", "fitness_center", "dog_park", "playground", "trail", …]` |

## Zoning

| Field | API name | Type | What it means | Example |
|---|---|---|---|---|
| Existing Zoning | `existingZoning` | string (nullable) | The site's zoning before the request. | `"PD"` |
| Proposed Zoning | `proposedZoning` | string (nullable) | The zoning being requested. | `"PD"` |
| Is Rezone | `isRezone` | boolean (nullable) | Yes when the request changes the site's zoning. | `true` |
| Variances Requested | `variancesRequested` | array | Exceptions to the zoning rules the applicant asked for. | `[]` |

## Construction

| Field | API name | Type | What it means | Example |
|---|---|---|---|---|
| Construction Type | `constructionType`, `constructionTypeLabel` | string (nullable) | The kind of work, such as a new building or a renovation. | `"new_building"` |
| Project Size | `projectSize`, `projectSizeLabel` | string (nullable) | How large the construction is: large, medium, or small. | `"large"` |
| Likely Trades | `likelyTrades` | array | Trades the project will likely need, with the reason for each. | `[]` |

## Contacts

| Field | API name | Type | What it means | Example |
|---|---|---|---|---|
| Developer / Applicant | `developerCompany` | string (nullable) | The company developing or applying for the project. | `"JPI Development"` |
| Developer Company Role | `developerCompanyRole`, `developerCompanyRoleLabel` | string (nullable) | Whether that company is the developer, builder, or applicant. | `"developer"` |
| Contacts | `contacts` | array | People and firms on the project, with email and phone on paid plans. | `[{ "name": "…", "role": "applicant", "company": "JPI Development", "email": null, … }]` |
| Contact Enrichment | `contactEnrichment` | object | The result of looking up contact details for this record. | `{ "status": "not_requested", "contactsFound": 0, … }` |
| Company Enrichment | `companyEnrichment` | array | Company details such as official name, website, and main phone. | `[]` |
| Public Officials | `publicOfficials` | array | Officials and staff named in the public record, without contact details. | `[{ "name": "…", "role": "planning_staff", "organization": "City of Mesquite", … }]` |
| Contact Summary | `contactSummary` | object | Counts of the contacts found, and how many were held back. | `{ "externalCount": 1, "governmentCount": 1, "withEmail": 0, … }` |

## Evidence

| Field | API name | Type | What it means | Example |
|---|---|---|---|---|
| Key Facts | `keyFacts` | array | Key facts from the filing, each with its category. | `[{ "fact": "291-unit multi-family project on approximately 12 acres", "category": "scale" }, …]` |
| Evidence | `evidence` | string (nullable) | The passage in the record that supports the current status. | `"The Planning and Zoning Commission recommends approval with certain stipulations."` |
| Project Summary | `summary` | string (nullable) | A short summary of what is planned, by whom, and where it stands. | `"JPI Development is moving forward with Torrington Creekside, a 291-unit, four-story multifamily development on 12 acres …"` |
| Conditions of Approval | `conditionsOfApproval` | array | Conditions attached to an approval, word for word. | `[]` |

## Alert match

| Field | API name | Type | What it means | Example |
|---|---|---|---|---|
| Alert Match | `alertMatch` | object (nullable) | Why this project matched your Alert. | `null` |
| AI Match | `aiMatch` | object (nullable) | Why AI Search matched this project, and how closely. | `null` |

## Decisions

| Field | API name | Type | What it means | Example |
|---|---|---|---|---|
| Vote Summary | `voteSummary` | object (nullable) | The tally of the latest recorded vote. | `{ "yes": 7, "no": 0, "total": 7, "isUnanimous": true, "meetingDate": "2026-02-16" }` |
| Decisions | `decisions` | array | Every recorded decision, newest first, with the votes cast. | `[{ "meetingDate": "2026-02-16", "decisionBody": "City of Mesquite City Council", "outcome": "approved", … }]` |

## Documents

| Field | API name | Type | What it means | Example |
|---|---|---|---|---|
| Source Document | `sourceDocumentUrl` | string (nullable) | A link to the original meeting document on the city's or county's site. | `"https://legistar1.granicus.com/Mesquite/meetings/2026/2/1587_M_City_Council_26-02-16_Minutes_-_Final.pdf"` |
| Original Raw Text | `originalRawText` | string (nullable) | The text of the meeting record this project came from. | `"Conduct a public hearing and consider an ordinance for Zoning Application No. Z1225-0433 submitted by JPI Development …"` |
| Original Raw Text Truncated | `originalRawTextTruncated` | boolean (nullable) | Yes when that text was cut at the length limit. | `false` |

## Get the full data

- **Count for free.** Connect Boardwalk to Claude or ChatGPT and ask how many projects match. Counting is free during your trial and on every plan. [Use it in Claude or ChatGPT](https://boardwalkai.com/mcp/)
- **Open the records.** Start a 7-day free trial, no credit card. It includes 50 project records. [Start free trial](https://boardwalkai.com/auth/signup/)
- **Use it in your tools.** CSV export, the API, and the MCP server come with every plan. [API docs](https://boardwalkai.com/docs/api/)

## How to cite

Source: Boardwalk, "Data dictionary", boardwalkai.com/data-dictionary/, data as of Oct 11, 2026.

How we count: https://boardwalkai.com/coverage/#how-we-count