311 requests to Cityworks
New requests from the city's Open311 endpoint become Cityworks service requests for public works crews.
Service requests & work ordersConnector
Open311 GeoReport v2 integration
for 311 systems
Open311 GeoReport v2 is an open standard for 311 service requests. Many 311 and resident request systems publish it, so apps and other systems can list service types, create requests and check their status.
Pre-built connector
Open311 (GeoReport v2)
- Tier
- Pre-built connector
- Category
- Service requests & work orders
- Sign-in
- API key in the address
- Paging
- single response
§ Overview
What connecting Open311 does.
SentraBridge reads requests changed since the last run, reads service types and creates new requests through any GeoReport v2 endpoint. That makes it a common bridge between a 311 product and a work order or asset system. Requests pass through without being stored.
- Service requests: Read requests: service code, description, address, coordinates and status.
- New requests: Create requests through the endpoint with the vendor's API key.
- Service types: Read codes, names, groups and descriptions.
What SentraBridge can do with Open311 (GeoReport v2)
| resource | read | write | changes only | fields |
|---|---|---|---|---|
| Service requests | list, read one | create | yes | Request ID, Service code, Service, Status, Description, Address… |
| Service types | list | — | — | Code, Name, Group, Description |
§ Use cases
What cities connect Open311 for.
Requests to the city database
Changed requests are upserted into PostgreSQL with a map point for reporting and GIS.
Phone requests into the 311 system
Requests logged by another department are posted to the 311 vendor's Open311 endpoint with an API key.
Open data publishing
Closed requests are published to the city's Socrata open-data portal nightly.
§ How it works
How to connect Open311
- 01Get accessFind the 311 vendor's GeoReport v2 endpoint and jurisdiction ID.
- 02Add the connectionReading is often open; ask the vendor for an API key to create requests.
- 03Preview real recordsEnter the endpoint and key, sent as api_key.
- 04Turn it onPreview service types to map categories.
§ Often connected with
Open311 and the rest of city hall.
Systems cities commonly connect with Open311, each with its own connector page.
§ FAQ
Open311 integration questions
What is Open311?
Open311 GeoReport v2 is an open API standard for 311 service requests: list service types, create a request, and read request status.
Does my 311 system support Open311?
Many 311 systems publish a GeoReport v2 endpoint. Ask your vendor for the endpoint address and an API key for creating requests.
How do I connect Open311 to Cityworks?
Read changed requests on a schedule, map service codes to Cityworks problem types, and create service requests. Write the Cityworks ID back if the 311 system allows.
Connect Open311 (GeoReport v2) to the rest.
We'll set up a workspace with your systems in a sandbox and build your first flow with you.