# CityMinutes.ai Data Schema

Canonical: https://cityminutes.ai/product/data-schema
Last updated: 2026-04-15

## Four-Field Wedge
- Conditions of Approval
- Community Objections
- Hearing Outcomes
- Staff Recommendations

## Core Record Fields
- `case_id`: jurisdiction case identifier.
- `jurisdiction`: city, county, planning commission, zoning board, or council body.
- `meeting_date`: public meeting date.
- `hearing_type`: rezoning, variance, conditional-use permit, subdivision, site plan, PUD, general plan amendment, or related public planning action.
- `applicant`: applicant or representative named in the source record.
- `parcel_id`: APN or parcel join key when available.
- `source_url`: canonical public source page.
- `source_pdf_page`: source page for extracted field evidence.
- `extraction_confidence`: field-level confidence score.
- `last_updated`: CityMinutes refresh timestamp.

## Provenance Contract
Every production record should carry a source URL, source document hash where available, page reference, and freshness timestamp so buyers can verify the extracted fact against the public record.
