For developers
API, webhooks and MCP
Read GovMeet from your own code, ask it from an AI assistant, or have alerts pushed into Slack, Teams and your own systems. One key does the first two. Everything is free during early access.
Start in a minute
- Sign in and make a key. It is shown once; keep it like a password.
- Ask for the land cases on agendas in a state:
curl -H "Authorization: Bearer YOUR_KEY" "https://govmeet.us/api/v1/cases?state=FL&limit=5"
Every answer is JSON. Every case links to its page here and to the page of the public document it came from.
Keys, limits and errors
Send the key in a header on every request: Authorization: Bearer YOUR_KEY. A key reads; it cannot change
anything. Revoke it on the keys page and it stops working within a minute.
Each key may make 60 requests a minute and 5,000 a day. X-RateLimit-Remaining says what is
left of the minute; past the limit the answer is 429 with Retry-After in seconds.
An error is always this shape, with the HTTP status to match:
{
"error": {
"code": "bad_request",
"message": "state must be a two-letter code, like FL"
}
}
400 bad_request- A parameter is missing or wrong; the message says which.
401 missing_key, invalid_key- No key, or one we do not know or that was revoked.
403 plan- The account's plan does not include the API.
404 not_found- No such case, government, meeting or endpoint.
429 rate_limited- Slow down;
Retry-Aftersays for how long. 503 too_slow, search_unavailable- The read took too long or the search is being rebuilt; try again shortly.
Land cases
GET /api/v1/cases: the rezonings, annexations, plats and other land cases on agendas, from 30 days back to 90
days ahead. Give at least a state, a county or a government.
state- Two-letter code:
FL. county- Five-digit county FIPS code:
12057. government- A government's id (see governments).
kind- One or more of a case's
kinds, comma-separated:rezoning,annexation,pud,subdivision_plat,site_plan,industrial,industrial_land,housing,manufactured_housing,moratorium,comp_plan,special_use,variance,zoning_text,infrastructure,water_sewer,incentives,surplus_land,jobs. Default: the land kinds the feed shows. whenupcoming(default),decided(the last 30 days, with a posted result) orall.days- With
upcoming: how far ahead, 1 to 90. Default 30. min_acres- Only cases of at least this size. A case that states no size is left out when this is set.
limit, offset- Up to 100 a page (default 50).
next_offsetin the answer is the next page, or null.
{
"total": 318,
"limit": 50,
"offset": 0,
"next_offset": 50,
"cases": [
{
"id": 5480112,
"url": "https://govmeet.us/app/case/5480112",
"headline": "92 single-family lots — 4325 77th Street East, Example City, Florida",
"agenda_line": "Z-2026-041: Request by Example Land Partners LLC to rezone 27.34 acres at 4325 77th Street East from A (General Agriculture) to PDR (Planned Development Residential) for 92 single-family lots",
"kinds": [
"rezoning",
"pud"
],
"status": "upcoming",
"stage": "Hearing in 5 days",
"result": null,
"acres": 27.34,
"government": {
"id": 812,
"name": "Example County",
"state": "FL",
"county_fips": "12081",
"url": "https://govmeet.us/gov/812"
},
"body": "Board of County Commissioners",
"meeting": {
"id": 771204,
"starts_at": "2026-11-17T09:00-05:00",
"timezone": "America/New_York",
"url": "https://govmeet.us/meeting/771204"
},
"case_key": "812:cz2026041",
"records": [
{
"case_number": "Z-2026-041",
"proposed_use": "92 single-family lots",
"address": "4325 77th Street East, Example City, Florida",
"acreage": "27.34",
"units": "92",
"zoning_from": "A",
"zoning_to": "PDR",
"applicant": "Example Land Partners LLC"
}
],
"recommendation": null,
"vote": null,
"location": {
"lat": 27.52468,
"lon": -82.51377
},
"links": {
"agenda_page": "https://www.example-county.gov/agendas/2026-11-17.pdf#page=3",
"agenda": "https://www.example-county.gov/meetings/771204",
"minutes": null
},
"first_seen_at": "2026-11-03T14:10:00+00:00"
},
"…"
]
}
One case
GET /api/v1/cases/{id}: the same object for any agenda line, however old, with three more fields:
document (the file it is in: id, address, pages), steps (the other agenda lines of the same case,
newest first, each with its status and result) and item_no / matter_file as the government numbers it.
Search
GET /api/v1/search: every agenda line with your words, land case or not: a company, a street, a product, a rule.
The same search as the search page.
q- The words. Quotes for an exact phrase,
ORbetween alternatives, a minus sign to leave a word out:"data center" -moratorium. state- Two-letter code, to stay in one state.
whenrecent(default: the meetings ahead and the last six months),upcoming,5y(five years back) or one year, like2024.landtrue: only lines tagged as land cases.limit- Up to 100 (default 50). The meetings ahead come first, then the past, newest first.
The answer has query, count and results, each a case object.
Governments
GET /api/v1/governments: the counties, cities, towns and townships we know, the biggest first. Give a
state, or q with at least three letters of the name. covered says whether we read its meetings.
GET /api/v1/governments/{id}: one government with its meetings in the next 60 days, the number of land cases on
agendas ahead, and track_record: how its land cases ended in the last five years, from the results it posts.
Null for a government that posts no results by item.
{
"track_record": {
"all": {
"kind": "all",
"decided": 524,
"approved": 486,
"denied": 26,
"withdrawn": 12,
"approval_rate": 0.927,
"on_more_than_one_agenda": 58,
"median_days_to_decision": 35.0,
"first_decision": "2021-11-16",
"last_decision": "2026-10-27"
},
"by_kind": [
{
"kind": "rezoning",
"decided": 212,
"approved": 190,
"denied": 15,
"withdrawn": 7,
"approval_rate": 0.896,
"on_more_than_one_agenda": 41,
"median_days_to_decision": 42.0,
"first_decision": "2021-11-16",
"last_decision": "2026-10-27"
}
],
"updated_at": "2026-11-12T15:00:00+00:00"
}
}
A case counts once, by its last posted decision. median_days_to_decision is from the first agenda
to the decision, for the cases that were on more than one agenda.
Meetings and documents
GET /api/v1/meetings/{id}: one meeting with every line of its agenda (lines, as case objects) and its
files (documents: id, kind, name, address, pages).
GET /api/v1/documents/{id}/text?from=3&to=6: the text of some pages of an agenda or minutes file, 20 pages a
request at most. Each page comes with a link that opens the file at that page.
The case object
One agenda line. The API, the webhooks and the MCP tools all return this shape.
id, url- The line's number here and its page on GovMeet.
headline- What is proposed and where, in plain words, when the filing has been read; else the agenda line, tidied.
agenda_line- The line as the government posted it.
kinds- What it is:
rezoning,annexation,pud,subdivision_plat,site_plan,comp_plan,special_use,variance,moratoriumand the others listed under cases. Empty for a line that is no land case (search returns those too). statusupcoming,approved,denied,withdrawn,held_over(continued, tabled, deferred),in_progress(a reading or a referral),result_not_posted,date_not_posted.stage- The same in words for a person: “Hearing in 5 days”, “Passed Oct 14”.
result- The result as the minutes or the vote record word it; null until one is posted.
acres- The size, when the agenda or the filing states it.
government, body- Who decides: the government (id, name, state, county FIPS) and its board.
meeting- The meeting it is on: id, start in the government's own time zone with its offset, the zone's name.
case_key- The same value on every step of one case (first reading, hearing, vote), when the government numbers its cases.
records- What the filing states, read by AI and shown with its source sentence on the case page:
case_number,proposed_use,address,parcel_id,acreage,units,square_feet,zoning_from,zoning_to,applicant,owner,developer,agent_or_engineer,vote. One object per application; an agenda line can bundle several. Empty when the filing has not been read yet. location- Latitude and longitude of the site, when the filing gives a street address the US Census geocoder can place.
links- The page of the agenda file the line is on, the agenda, and the minutes once posted.
first_seen_at- When we first read the line.
{
"id": 5480112,
"url": "https://govmeet.us/app/case/5480112",
"headline": "92 single-family lots — 4325 77th Street East, Example City, Florida",
"agenda_line": "Z-2026-041: Request by Example Land Partners LLC to rezone 27.34 acres at 4325 77th Street East from A (General Agriculture) to PDR (Planned Development Residential) for 92 single-family lots",
"kinds": [
"rezoning",
"pud"
],
"status": "upcoming",
"stage": "Hearing in 5 days",
"result": null,
"acres": 27.34,
"government": {
"id": 812,
"name": "Example County",
"state": "FL",
"county_fips": "12081",
"url": "https://govmeet.us/gov/812"
},
"body": "Board of County Commissioners",
"meeting": {
"id": 771204,
"starts_at": "2026-11-17T09:00-05:00",
"timezone": "America/New_York",
"url": "https://govmeet.us/meeting/771204"
},
"case_key": "812:cz2026041",
"records": [
{
"case_number": "Z-2026-041",
"proposed_use": "92 single-family lots",
"address": "4325 77th Street East, Example City, Florida",
"acreage": "27.34",
"units": "92",
"zoning_from": "A",
"zoning_to": "PDR",
"applicant": "Example Land Partners LLC"
}
],
"recommendation": null,
"vote": null,
"location": {
"lat": 27.52468,
"lon": -82.51377
},
"links": {
"agenda_page": "https://www.example-county.gov/agendas/2026-11-17.pdf#page=3",
"agenda": "https://www.example-county.gov/meetings/771204",
"minutes": null
},
"first_seen_at": "2026-11-03T14:10:00+00:00"
}
Webhooks
Have alerts sent to an https address of yours the moment a watch finds something: your own service, or Zapier, Make or n8n, which is the way into Salesforce or HubSpot. Connect the address on the alerts page, tick Webhook on a watch, and send yourself a test from there.
cases.new- A watch found new cases.
watchsays which. cases.digest- The daily digest or the Monday brief of a watch: the cases held for it.
case.update- A case you follow: a new step, a hearing tomorrow, or the result.
notesays which. test- The test you sent from the alerts page.
{
"event": "cases.new",
"sent_at": "2026-11-12T15:00:00+00:00",
"watch": {
"id": 41,
"name": "Example County, FL"
},
"note": "New on an agenda in Example County, FL, before the vote.",
"cases": [
{
"id": 5480112,
"url": "https://govmeet.us/app/case/5480112",
"headline": "92 single-family lots — 4325 77th Street East, Example City, Florida",
"agenda_line": "Z-2026-041: Request by Example Land Partners LLC to rezone 27.34 acres at 4325 77th Street East from A (General Agriculture) to PDR (Planned Development Residential) for 92 single-family lots",
"kinds": [
"rezoning",
"pud"
],
"status": "upcoming",
"stage": "Hearing in 5 days",
"result": null,
"acres": 27.34,
"government": {
"id": 812,
"name": "Example County",
"state": "FL",
"county_fips": "12081",
"url": "https://govmeet.us/gov/812"
},
"body": "Board of County Commissioners",
"meeting": {
"id": 771204,
"starts_at": "2026-11-17T09:00-05:00",
"timezone": "America/New_York",
"url": "https://govmeet.us/meeting/771204"
},
"case_key": "812:cz2026041",
"records": [
{
"case_number": "Z-2026-041",
"proposed_use": "92 single-family lots",
"address": "4325 77th Street East, Example City, Florida",
"acreage": "27.34",
"units": "92",
"zoning_from": "A",
"zoning_to": "PDR",
"applicant": "Example Land Partners LLC"
}
],
"recommendation": null,
"vote": null,
"location": {
"lat": 27.52468,
"lon": -82.51377
},
"links": {
"agenda_page": "https://www.example-county.gov/agendas/2026-11-17.pdf#page=3",
"agenda": "https://www.example-county.gov/meetings/771204",
"minutes": null
},
"first_seen_at": "2026-11-03T14:10:00+00:00"
}
]
}
Answer with any 2xx status within 10 seconds. An alert from a watch that does not get through is tried again every five
minutes for 48 hours; a digest goes out again with the next one. The same case can arrive twice, so use its id
to tell. We connect to public https addresses on port 443 only and do not follow redirects.
Check the signature
Every request carries X-GovMeet-Signature: t=1794495600,v1=…: the time it was sent and an HMAC-SHA256 of
t, a dot and the raw body, made with the signing secret on your alerts page. Check it before trusting a request,
and refuse one older than five minutes.
import hashlib, hmac, time
def verified(secret: str, header: str, body: bytes, max_age: int = 300) -> bool:
"""header: the X-GovMeet-Signature value; body: the raw request body, before any JSON parsing."""
parts = dict(p.split("=", 1) for p in header.split(","))
want = hmac.new(secret.encode(), parts["t"].encode() + b"." + body, hashlib.sha256).hexdigest()
return hmac.compare_digest(want, parts["v1"]) and abs(time.time() - int(parts["t"])) <= max_age
const crypto = require("crypto");
function verified(secret, header, rawBody, maxAge = 300) {
const parts = Object.fromEntries(header.split(",").map((p) => p.split("=")));
const want = crypto.createHmac("sha256", secret).update(`${parts.t}.${rawBody}`).digest("hex");
const same = want.length === parts.v1.length && crypto.timingSafeEqual(Buffer.from(want), Buffer.from(parts.v1));
return same && Math.abs(Date.now() / 1000 - Number(parts.t)) <= maxAge;
}
Slack and Teams
The same alerts as a message in the channel your team reads: what is proposed, where, when it is heard, and a link to the case. On the alerts page, paste the address of a Slack incoming webhook or of a Teams Workflows webhook, tick Slack or Teams on a watch, and send a test. Nothing to install on our side.
MCP server
An AI assistant that speaks the Model Context Protocol can read GovMeet itself: “what is on agendas in Polk County next week”, “has this council denied a rezoning this year”. Add a server (Streamable HTTP) with this address and your key as a Bearer token:
https://govmeet.us/mcp
An assistant that cannot send a header can carry the key in the address instead: https://govmeet.us/mcp?key=YOUR_KEY.
Treat that address like the key itself.
land_cases- The land cases on agendas in a state, a county or one government: upcoming, decided or both.
get_case- One case: what the filing states, where it is, its other steps.
search_agendas- Every agenda line with the words, five years back.
find_governments- Governments by state or name.
get_government- One government: meetings ahead, land cases ahead, how its land cases end.
get_meeting- One meeting with its agenda lines and files.
get_document_text- The text of some pages of an agenda or minutes file.
The tools read; none can change anything. The same limits apply as for the API.
Changes
Version 1. We add fields and endpoints without notice; anything that would break a client gets a new version first. Questions: support@govmeet.us.