Clearly, government agencies should default to observing the broader trends of API producers but are there particular best practices that a government API should follow?

(Disclaimer - I am the Sr. API Strategist for GSA)

  • does section 508 count?
    – Joe
    May 16, 2013 at 7:08
  • 2
    This is a really broad question. Are you asking about technical best practices? Ethical best practices? Usability best practices? May 21, 2013 at 14:51
  • Keep backward compatibility. May 22, 2013 at 12:47
  • I provided a technical answer to a similar question.
    – John
    May 24, 2013 at 16:19
  • @Joe-Germuska, technical and usability, though I'm open to other dynamics if you think though.
    – Gray B.
    May 24, 2013 at 20:55

2 Answers 2


You don't identify what kind of areas you're looking for advice on. But I'll highlight several that I think are particularly relevant for Government sources:

  • Where feasible, data should not just be made available via an API, but also available for download. This supports other kinds of uses. I think this is important as one goal of Open Government Data is to drive innovation and creation of new businesses. This is easier to do if the entire dataset is available. For example third-parties can offer value-added services over that data.

  • APIs should be accessible without usage restrictions or API keys. This avoids having any barriers to entry. Scaling may be an issue, but it'd be better to offer an open, unsupported API and then offer alternatives for higher-volume usage (and this is the kind of value-add that a third-party can offer)

  • Data must be clearly licensed. And that licensing information should be included not just in the API documentation but discoverable from the data itself. E.g. linked in API responses. Users should be crystal clear on how they can re-purpose the data. This is important for all Open Data, but particularly so for government.

  • Use of Open Standards. Again, this is a benefit in all cases, but government providers should avoid using proprietary formats or data protocols that might impede usage.


Versioning of your API's, please!

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.