{"openapi":"3.1.0","info":{"title":"ZoneWire API","version":"1.0.0","description":"Read API for US council-meeting zoning intelligence drawn from official sources. Keyless at the free tier, or Authorization: Bearer zw_live_... zonewire.co does not sell list pages one at a time. People buy Pro ($39 per county per month), Elite ($199 per month) or a single meeting ($9, one time) on the website. Software that can attach a payment credential, such as an AI agent with a wallet, can buy a $9 meeting record or a $1 list page through the ZoneWire API or MCP server. A person using such an agent is welcome to buy this way.","contact":{"email":"support@zonewire.co"},"x-guidance":"Start with GET /api/v1/counties for county slugs. GET /api/v1/search?q=rezoning and GET /api/v1/decisions return a free sample on a bare GET; filter with county (a slug) and, on decisions, since (an ISO date), type (rezoning or a card type) and body (a governing body name). Search with no kind returns up to 5 rows per kind plus per-kind totals and no cursor; agenda q matches agendas with all the words, most relevant first. Keyless callers get 5 keyless data reads per client IP per UTC day: a 200 data response counts, and so does a 402 that carries a free preview (the meeting record offer); errors, 402s without a preview and HEAD requests do not (/api/v1/me and /api/v1/counties never count); a free API key from https://www.zonewire.co/dashboard/account, sent as Authorization: Bearer zw_live_..., lifts that. Pro and Elite keys read meeting detail (GET /api/v1/meetings?id=<id>, also served at /api/v1/meetings/{id}) and incremental sync (GET /api/v1/changes) in their counties. Transcript text and audio are never served. Without a covering key, GET /api/v1/meetings?id=<id> or /api/v1/meetings/{id} ($9.00 meeting record), GET /api/v1/changes and every search, decisions or changes next_cursor page ($1.00, up to 10 reference rows) answer 402 Payment Required. With x402 (USDC on Base), sign the PAYMENT-REQUIRED offer and retry the same URL with it in PAYMENT-SIGNATURE. With MPP, retry with a credential for one of the WWW-Authenticate Payment challenges in Payment-Authorization (USDC on Base (x402), stablecoin on Tempo, card or Link (Stripe shared payment token)). The same credential re-serves the same resource free for 24 hours. zonewire.co does not sell list pages one at a time. People buy Pro ($39 per county per month), Elite ($199 per month) or a single meeting ($9, one time) on the website. Software that can attach a payment credential, such as an AI agent with a wallet, can buy a $9 meeting record or a $1 list page through the ZoneWire API or MCP server. A person using such an agent is welcome to buy this way."},"servers":[{"url":"https://www.zonewire.co"}],"x-service-info":{"categories":["data","real-estate"],"docs":{"homepage":"https://www.zonewire.co","apiReference":"https://www.zonewire.co/docs/api","llms":"https://www.zonewire.co/llms.txt","mcp":"https://mcp.zonewire.co"}},"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"A zw_live_ API key."}}},"security":[{},{"bearer":[]}],"paths":{"/api/v1/me":{"get":{"operationId":"getMe","summary":"The caller's tier and county scope, plus the key's metadata when a key is sent. Free; send Authorization: Bearer zw_live_... to see your key's scope.","parameters":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"tier":{"type":"string","enum":["free","pro","elite"]},"counties":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"state":{"type":"string"},"slug":{"type":"string"}}}},"key":{"anyOf":[{"type":"object"},{"type":"null"}]},"demo":{"type":"boolean"}}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}},"401":{"description":"Missing or invalid Bearer key (a bad key never falls back to keyless)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}},"429":{"description":"Keyless daily cap reached (5 keyless data reads per client IP per UTC day: a 200 data response counts, and so does a 402 that carries a free preview (the meeting record offer); errors, 402s without a preview and HEAD requests do not)","content":{"application/problem+json":{"schema":{"type":"object","properties":{"code":{"type":"string"},"required_tier":{"type":"string"},"upgrade_url":{"type":"string"},"message":{"type":"string"}}}}}}},"security":[]}},"/api/v1/counties":{"get":{"operationId":"listCounties","summary":"The active county catalog. Every tier gets the whole list. Free; send Authorization: Bearer zw_live_... to see your key's scope at /api/v1/me.","parameters":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"state":{"type":"string"},"slug":{"type":"string"}}}}}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}},"401":{"description":"Missing or invalid Bearer key (a bad key never falls back to keyless)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}},"429":{"description":"Keyless daily cap reached (5 keyless data reads per client IP per UTC day: a 200 data response counts, and so does a 402 that carries a free preview (the meeting record offer); errors, 402s without a preview and HEAD requests do not)","content":{"application/problem+json":{"schema":{"type":"object","properties":{"code":{"type":"string"},"required_tier":{"type":"string"},"upgrade_url":{"type":"string"},"message":{"type":"string"}}}}}}},"security":[]}},"/api/v1/search":{"get":{"operationId":"search","summary":"Keyword lookup across the projects catalog, decision records and meeting agendas. Free callers get a sample; entitled keys page through every row. Without kind the response is a summary: up to 5 rows per kind, per-kind totals, and no next_cursor. Free sample on a bare GET. Following next_cursor costs $1.00 per page of up to 10 reference rows; the cursor URL answers 402 with x402 (USDC on Base) and MPP (USDC on Base (x402), stablecoin on Tempo, card or Link (Stripe shared payment token)) offers.","parameters":[{"name":"q","in":"query","required":true,"description":"Search text, at least 2 characters. Projects and decisions match it as a substring of the name or headline. Agendas use stemmed full-text matching: an agenda matches when it contains all the words, and results come back most relevant first (the exact phrase, then the words close together, then the newest meeting); quote an exact phrase, write OR between words for either, -word to exclude.","schema":{"type":"string"},"example":"rezoning"},{"name":"kind","in":"query","required":false,"description":"project, decision or agenda. Required with a cursor; without it the response is the per-kind summary.","schema":{"type":"string","enum":["project","decision","agenda"]}},{"name":"county","in":"query","required":false,"description":"County slug from /api/v1/counties.","schema":{"type":"string"},"example":"raleigh"},{"name":"limit","in":"query","required":false,"description":"Rows per page for entitled keys (1 to 50).","schema":{"type":"integer"}},{"name":"cursor","in":"query","required":false,"description":"Opaque cursor from a previous next_cursor.","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["project","decision","agenda"]},"id":{"type":"string"},"name":{"type":"string"},"county_slug":{"type":["string","null"]},"meeting_date":{"type":["string","null"]},"snippet":{"type":["string","null"]}}}},"total":{"type":"integer"},"truncated":{"type":"boolean","description":"Present on free samples."},"upgrade_url":{"type":"string","description":"Present on free samples."},"next_cursor":{"type":["string","null"],"description":"Pass back verbatim as cursor. For a keyless or free caller the GET with this cursor is the next $1.00 paid page (up to 10 reference rows): it answers 402 with x402 (USDC on Base) and MPP (USDC on Base (x402), stablecoin on Tempo, card or Link (Stripe shared payment token)) offers. Entitled keys page free."},"totals":{"type":"object","description":"Summary mode only (no kind): matches per kind. data then holds at most 5 rows of each kind and there is no next_cursor; send kind to page one kind.","properties":{"project":{"type":"integer"},"decision":{"type":"integer"},"agenda":{"type":"integer"}}}}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}},"401":{"description":"Missing or invalid Bearer key (a bad key never falls back to keyless)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}},"402":{"description":"Payment Required: WWW-Authenticate Payment challenges, one per offer; retry with the credential in the Payment-Authorization header. With the Base rail on, PAYMENT-REQUIRED also carries an x402 offer; retry with the x402 payment in PAYMENT-SIGNATURE.","content":{"application/problem+json":{"schema":{"type":"object","properties":{"code":{"type":"string"},"required_tier":{"type":"string"},"upgrade_url":{"type":"string"},"message":{"type":"string"}}}}}},"403":{"description":"The tier or county your key holds does not cover this request","content":{"application/problem+json":{"schema":{"type":"object","properties":{"code":{"type":"string"},"required_tier":{"type":"string"},"upgrade_url":{"type":"string"},"message":{"type":"string"}}}}}},"429":{"description":"Keyless daily cap reached (5 keyless data reads per client IP per UTC day: a 200 data response counts, and so does a 402 that carries a free preview (the meeting record offer); errors, 402s without a preview and HEAD requests do not)","content":{"application/problem+json":{"schema":{"type":"object","properties":{"code":{"type":"string"},"required_tier":{"type":"string"},"upgrade_url":{"type":"string"},"message":{"type":"string"}}}}}}},"security":[]}},"/api/v1/decisions":{"get":{"operationId":"listDecisions","summary":"The decision catalog, newest hearing first. Free callers get a sample; entitled keys page through every row. Free sample on a bare GET. Following next_cursor costs $1.00 per page of up to 10 reference rows; the cursor URL answers 402 with x402 (USDC on Base) and MPP (USDC on Base (x402), stablecoin on Tempo, card or Link (Stripe shared payment token)) offers.","parameters":[{"name":"county","in":"query","required":false,"description":"County slug from /api/v1/counties.","schema":{"type":"string"},"example":"raleigh"},{"name":"since","in":"query","required":false,"description":"ISO date; filters on meeting_date.","schema":{"type":"string"},"example":"2026-09-01"},{"name":"type","in":"query","required":false,"description":"rezoning (a change to a property's zoning district: a zone change or a rezoning headline) or one card type: upzone, downzone, density_increase, use_conversion, annexation, variance, entitlement, moratorium. Any other value is a 400 (it used to be ignored).","schema":{"type":"string","enum":["rezoning","upzone","downzone","density_increase","use_conversion","annexation","variance","entitlement","moratorium"]}},{"name":"body","in":"query","required":false,"description":"Governing body, exactly as rows report it in body (case-insensitive), e.g. Planning Commission.","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Rows per page for entitled keys (1 to 100).","schema":{"type":"integer"}},{"name":"cursor","in":"query","required":false,"description":"Opaque cursor from a previous next_cursor.","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"array","items":{"type":"object","properties":{"decision_id":{"type":"string"},"county_slug":{"type":["string","null"]},"county_name":{"type":["string","null"]},"meeting_id":{"type":["integer","null"]},"meeting_date":{"type":["string","null"]},"body":{"type":["string","null"],"description":"The governing body the decision was made at; the value the body filter matches."},"headline":{"type":["string","null"]},"stage":{"type":["string","null"],"description":"The decision's outcome stage: proposed, first_reading, approved, denied, continued, failed (an approval motion that did not carry, not a denial), discussed (a work or study session item with no recorded vote) or introduced (an ordinance introduction)."},"vote_summary":{"type":["string","null"]},"display_outcome":{"type":["string","null"],"description":"The outcome word ZoneWire shows on this decision card (Approved, Denied, Motion failed, Appeal decided, Appeal pending and so on). An appeal decided as approved or denied whose recorded type cannot be taken as the project result reads Appeal decided or Appeal pending. stage is unchanged."},"appeal_party":{"type":"string","enum":["third_party","applicant","none"],"description":"Who filed the appeal this decision hears: third_party (for example neighbors appealing an approval), applicant, or none. Read from the decision title and description when the card was stored with that reading; for older cards, from the card title or headline only."},"appeal_gate":{"type":["string","null"],"enum":["not_final","not_a_project","untrusted_denial",null],"description":"Why an appeal decision cannot be read as the project result: not_final (still to be heard or decided), not_a_project (a tax, bid, licence or similar appeal) or untrusted_denial (recorded denied with no adverse action named); null otherwise."},"card":{"type":"object","description":"The decision card (entitled keys and free samples)."}}}},"total":{"type":"integer"},"truncated":{"type":"boolean","description":"Present on free samples."},"upgrade_url":{"type":"string","description":"Present on free samples."},"next_cursor":{"type":["string","null"],"description":"Pass back verbatim as cursor. For a keyless or free caller the GET with this cursor is the next $1.00 paid page (up to 10 reference rows): it answers 402 with x402 (USDC on Base) and MPP (USDC on Base (x402), stablecoin on Tempo, card or Link (Stripe shared payment token)) offers. Entitled keys page free."}}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}},"401":{"description":"Missing or invalid Bearer key (a bad key never falls back to keyless)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}},"402":{"description":"Payment Required: WWW-Authenticate Payment challenges, one per offer; retry with the credential in the Payment-Authorization header. With the Base rail on, PAYMENT-REQUIRED also carries an x402 offer; retry with the x402 payment in PAYMENT-SIGNATURE.","content":{"application/problem+json":{"schema":{"type":"object","properties":{"code":{"type":"string"},"required_tier":{"type":"string"},"upgrade_url":{"type":"string"},"message":{"type":"string"}}}}}},"403":{"description":"The tier or county your key holds does not cover this request","content":{"application/problem+json":{"schema":{"type":"object","properties":{"code":{"type":"string"},"required_tier":{"type":"string"},"upgrade_url":{"type":"string"},"message":{"type":"string"}}}}}},"429":{"description":"Keyless daily cap reached (5 keyless data reads per client IP per UTC day: a 200 data response counts, and so does a 402 that carries a free preview (the meeting record offer); errors, 402s without a preview and HEAD requests do not)","content":{"application/problem+json":{"schema":{"type":"object","properties":{"code":{"type":"string"},"required_tier":{"type":"string"},"upgrade_url":{"type":"string"},"message":{"type":"string"}}}}}}},"security":[]}},"/api/v1/meetings":{"get":{"operationId":"getMeeting","summary":"One meeting's insights and zoning mentions, by id. The same record is also served at /api/v1/meetings/{id}. Transcript text and audio are never served.","parameters":[{"name":"id","in":"query","required":true,"description":"Meeting id (from search or decisions).","schema":{"type":"integer","minimum":1,"example":8123,"examples":[8123]},"example":8123},{"name":"Payment-Authorization","in":"header","required":false,"description":"MPP credential for one of the WWW-Authenticate Payment challenges on the 402.","schema":{"type":"string"}},{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"description":"x402 payment payload (base64 JSON) for the PAYMENT-REQUIRED offer on the 402.","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"integer"},"title":{"type":"string"},"meeting_date":{"type":"string"},"county":{"anyOf":[{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"state":{"type":"string"},"slug":{"type":"string"}}},{"type":"null"}]},"insights":{"description":"The computed meeting insights."},"zoning_mentions":{"type":"array","items":{"type":"object"}}}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}},"401":{"description":"Missing or invalid Bearer key (a bad key never falls back to keyless)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}},"402":{"description":"Payment Required: WWW-Authenticate Payment challenges, one per offer; retry with the credential in the Payment-Authorization header. With the Base rail on, PAYMENT-REQUIRED also carries an x402 offer; retry with the x402 payment in PAYMENT-SIGNATURE.","content":{"application/problem+json":{"schema":{"type":"object","properties":{"code":{"type":"string"},"required_tier":{"type":"string"},"upgrade_url":{"type":"string"},"message":{"type":"string"}}}}}},"403":{"description":"The tier or county your key holds does not cover this request","content":{"application/problem+json":{"schema":{"type":"object","properties":{"code":{"type":"string"},"required_tier":{"type":"string"},"upgrade_url":{"type":"string"},"message":{"type":"string"}}}}}},"429":{"description":"Keyless daily cap reached (5 keyless data reads per client IP per UTC day: a 200 data response counts, and so does a 402 that carries a free preview (the meeting record offer); errors, 402s without a preview and HEAD requests do not)","content":{"application/problem+json":{"schema":{"type":"object","properties":{"code":{"type":"string"},"required_tier":{"type":"string"},"upgrade_url":{"type":"string"},"message":{"type":"string"}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"9.00"},"protocols":[{"x402":{}},{"mpp":{"method":"evm","intent":"charge","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"mpp":{"method":"tempo","intent":"charge","currency":"0x20C000000000000000000000b9537d11c60E8b50"}},{"mpp":{"method":"stripe","intent":"charge","currency":"usd"}}],"amount":"9000000","currency":"0x20C000000000000000000000b9537d11c60E8b50","description":"ZoneWire meeting record","intent":"charge","method":"tempo","recipient":"0x9afc3c963216eecaefef8049c65d7b4106d536c8"}}},"/api/v1/changes":{"get":{"operationId":"listChanges","summary":"Incremental sync over the last 90 days: one reference row per record that changed.","parameters":[{"name":"since","in":"query","required":false,"description":"ISO date within the last 90 days; filters on as_of_date.","schema":{"type":"string"}},{"name":"kind","in":"query","required":false,"description":"sellable_project, sellable_decision or council_meeting.","schema":{"type":"string"}},{"name":"county","in":"query","required":false,"description":"County slug from /api/v1/counties.","schema":{"type":"string"},"example":"raleigh"},{"name":"limit","in":"query","required":false,"description":"Rows per page for entitled keys (1 to 500).","schema":{"type":"integer"}},{"name":"cursor","in":"query","required":false,"description":"Opaque cursor from a previous next_cursor.","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["sellable_project","sellable_decision","council_meeting"]},"id":{"type":"string"},"county_slug":{"type":["string","null"]},"op":{"type":"string","enum":["upsert","delete"]},"as_of_date":{"type":"string"},"content_hash":{"type":["string","null"]}}}},"truncated":{"type":"boolean","description":"Present on free samples."},"upgrade_url":{"type":"string","description":"Present on free samples."},"next_cursor":{"type":["string","null"],"description":"Pass back verbatim as cursor. For a keyless or free caller the GET with this cursor is the next $1.00 paid page (up to 10 reference rows): it answers 402 with x402 (USDC on Base) and MPP (USDC on Base (x402), stablecoin on Tempo, card or Link (Stripe shared payment token)) offers. Entitled keys page free."}}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}},"401":{"description":"Missing or invalid Bearer key (a bad key never falls back to keyless)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}},"402":{"description":"Payment Required: WWW-Authenticate Payment challenges, one per offer; retry with the credential in the Payment-Authorization header. With the Base rail on, PAYMENT-REQUIRED also carries an x402 offer; retry with the x402 payment in PAYMENT-SIGNATURE.","content":{"application/problem+json":{"schema":{"type":"object","properties":{"code":{"type":"string"},"required_tier":{"type":"string"},"upgrade_url":{"type":"string"},"message":{"type":"string"}}}}}},"403":{"description":"The tier or county your key holds does not cover this request","content":{"application/problem+json":{"schema":{"type":"object","properties":{"code":{"type":"string"},"required_tier":{"type":"string"},"upgrade_url":{"type":"string"},"message":{"type":"string"}}}}}},"429":{"description":"Keyless daily cap reached (5 keyless data reads per client IP per UTC day: a 200 data response counts, and so does a 402 that carries a free preview (the meeting record offer); errors, 402s without a preview and HEAD requests do not)","content":{"application/problem+json":{"schema":{"type":"object","properties":{"code":{"type":"string"},"required_tier":{"type":"string"},"upgrade_url":{"type":"string"},"message":{"type":"string"}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"1.00"},"protocols":[{"x402":{}},{"mpp":{"method":"evm","intent":"charge","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"mpp":{"method":"tempo","intent":"charge","currency":"0x20C000000000000000000000b9537d11c60E8b50"}},{"mpp":{"method":"stripe","intent":"charge","currency":"usd"}}],"amount":"1000000","currency":"0x20C000000000000000000000b9537d11c60E8b50","description":"ZoneWire changes list page (up to 10 reference rows)","intent":"charge","method":"tempo","recipient":"0x9afc3c963216eecaefef8049c65d7b4106d536c8"}}}}}