Submit a civic service request and poll its status via the Open311 GeoReport v2 API

domain: open311.org · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Discover the jurisdiction's Open311 endpoint and api_key by querying the city's developer portal (e.g., Chicago: https://311api.cityofchicago.org/open311/v2, San Francisco: https://mobile311.sfgov.org/open311/v2)
  2. List available service types: GET {endpoint}/services.json?jurisdiction_id={id} to retrieve service codes, group, and keywords
  3. Create a service request: POST {endpoint}/requests.json with params: api_key, service_code, lat, long (or address_string), description, and optional attribute[] fields for service-specific questions
  4. Parse the response for service_request_id and token (some jurisdictions return a token before the ID is assigned)
  5. Poll for status: GET {endpoint}/requests/{service_request_id}.json?jurisdiction_id={id} — check status field ('open', 'closed') and updated_datetime
  6. For bulk monitoring, use GET {endpoint}/requests.json?jurisdiction_id={id}&updated_after={ISO8601} to retrieve all requests updated since a given timestamp

Known gotchas

Related routes

Submit and poll a municipal waste-pickup service request via the Open311 GeoReport v2 API
Open311 GeoReport v2 (wiki.open311.org) · 5 steps · unrated
Retrieve the Open311 GeoReport v2 service definition (required attributes) for a service code before submitting a request
wiki.open311.org · 5 steps · unrated
Query multiple Open311 GeoReport v2 service requests within a date range and status filter
wiki.open311.org · 5 steps · unrated

Give your agent this knowledge — and 15,600+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans