OKFestival 2014 Stories: Towards a standard open decisions API

This post was collaboratively written by Jogi Poikola and Markus Laine of Open Knowledge Finland, James McKinney of Open North, and Scott Hubli, Jared Ford, and Greg Brown of the National Democratic Institute. It’s cross-posted from the OpeningParliament Blog.


At this year's Open Knowledge Festival — a biennial gathering of open government advocates — there was considerable interest in moving toward greater standardization of APIs (application programming interface) relating to government decision-making processes. Web APIs help promote an open architecture for sharing content and data between communities and applications. Standardization of APIs for government decision-making data would allow tools built by civic innovators or governments to analyze or visualize data about government decision-making to be used across multiple jurisdictions, without needing to re-program the tool to accommodate differing data formats or ways of accessing the data.

Most government decision-making procedures involve similar processes (meetings, requests for public comment, etc.), decision-points (committee hearings, committee meetings, plenary sessions, etc.) and supporting documentation (agendas, draft legislation, information on voting records, etc.). Standardizing the ways that these types of information are structured allows tools for visualizing data about open government decision-making to be used across jurisdictions, as well as facilitating comparison of data and information.

To discuss the state of play with respect to open government decision-making APIs, Open Knowledge Finland, Open North, and the National Democratic Institute organized a session at the Open Knowledge Festival 2014 in Berlin to explore the possibilities for moving toward a global standard for APIs that deal with data on government decision-making.


The session began with brief discussion of current projects that seek to create international standards for either tools or specific types of government data, including Popolo, Poplus, Open Decisions API used in Helsinki and Jyväskylä and the Open Civic Data project.

Open Civic Data (OCD) provides an identifier system that can reliably identify political jurisdictions, which can be used to more easily link data on people, events, bills, and more. This project relies in part on Popolo, an international open government data specification that covers information related to the legislative branch, such as motions, votes, and organizational structures. While OCD and Popolo provide standards for data, a recently launched initiative called Poplus builds civic tech components, or small, generic technology tools that can be easily reused regardless of context, including tools to store and organize legislative bills or transcripts.

Similarly, city of Helsinki has developed Open Decisions API (called OpenAHJO), or a set of standards on decision-making data, including agendas, meeting documents, and other relevant types of information that speak to decision-making processes in municipal governments. Currently, this API is being used in the Finnish cities of Helsinki and Jyväskylä, with more cities in Finland expected to adopt the standard in the near future. Thus far, using the API for city data has made it easier for city officials to locate and use certain data and has simplified how citizens find and engage with city data. While the API currently works exclusively with municipal level data, there is no reason why such a standard couldn't be adapted to work with different levels of government, such as national level parliaments or legislatures.

Other relevant examples are Akoma Ntoso, an XML schema for decision-making or legislative data, and Open 311, an international effort to standardize information about the status of municipal government service requests, such as filling potholes, trimming trees or fixing streetlights. All of these projects have been highly useful for the open government community.


The growing demand for greater standardization — both among civil society organizations and, increasingly, governments — speaks to the utility and value of these efforts. For civil society and the public, standardized data simplifies the process of analyzing and scrutinizing government data, which can vastly improve the public's understanding of government decision-making processes. For governments, standardized decision-making data can cut costs, improve internal knowledge management practices, and encourage information sharing and collaboration across municipalities or governments. Standardized decision-making data may also promote increased collaboration and interaction between civil society and government. Given the potential value of expanding the coverage of a standard API for decision-making data, our session in Berlin focused primarily on one question: how can the open government community better support efforts toward convergence with respect to standardization of APIs for government open decision-making?

It was agreed that the first step in further developing and spreading an API for government open decision-making data is to collect use cases and needs that individuals, organizations, and governments may have, as well as to do a more comprehensive mapping of the API and data formats and tools that are currently being used. This is an important first step, and the initial coalition that was formed during the OK Fest session aims to work collaboratively to advance this process over the coming months.

The mapping would also help to assess how additional efforts toward standardization of APIs for government open decision-making data would build off and complement existing initiatives. There was broad consensus that demonstrating to governments how standardized decision data could simplify their work, cut costs, and generate mutually beneficial partnerships with civil society would help drive interest and buy-in. There was also agreement that, in addition to engaging the civic tech and government tech communities, it may also be helpful to engage more traditional international organizations that can play a role in credentialing and disseminating information on standards, such as the InterParliamentary Union (IPU), the international association of the world's national parliaments, and United Cities and Local Governments, the organization that seeks to be the voice of and an advocate for democratic local self-government. In general, we found an emerging international consensus that government and parliamentary information should be shared in open and structured formats, a prerequisite for functional APIs. As stated by the IPU, “open document standards, such as XML, should be used to prepare proposed legislation and other parliamentary documentation. Eventually all documentation and media should be made available using open standards.” If a standardized API gains value by being spread widely, then considering effective strategies for proliferation early in the process will be important. Such organizations would also likely be engaged in decision-making bodies that help to update any emerging global norms that include their membership.

There are, of course, multiple questions that will need to be grappled with as this effort progresses. For example, there are questions about the definition and boundaries of government open decision-making data. There are wide varieties of decision-making processes that exist in different types and levels of democratic governments around the world, and it will be important to assess how effectively this diversity can be reflected in a shared structure for government open decision-making data. It is also a recognized that this work is highly political; therefore, we welcome any interested individuals to participate in this project. In the coming months, the organizers of the session look forward to helping continue the conversation in moving toward shared principles or standards for open government decision-making APIs.


While it is still early days, it was clear from the discussion there was a great deal of interest in how the open government community can collaborate to better support the efforts of governments to become more transparent and open to the citizens they serve, as well as supporting the efforts of citizens to have opportunities to become better informed and more engaged in decisions that affect their lives.

Compile related projects

Do you know of existing projects or initiatives that are related? Please add relevant links to the list here or tweet them with #opendecisions.

Join the discussion

We look forward to continuing this conversation. Currently, the discussion is happening in several international email-lists, such as the W3C Open Government list, Open Civic Data list, Poplus list, Akoma Ntoso list, Open Knowledge list, and the OpeningParliament.org list. We decided not to create yet another list, but encourage people to join existing ones. The topic will also be taken forward in related future events, such as Global Legislative Openness Week.

Contact us

The initial coalition will catch up via Skype later this autumn. If you wish to join, please contact us at open.decision.API@gmail.com.