Proposed XBRL taxonomy for audited financial statements produced by US state and local governments
Branch: master
Clone or download
Pull request Compare This branch is 5 commits ahead of xbrlware:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
City of St Petersburg Updated 9.9.xlsm
St Petersburg OPEB Footnote.docx
US-CAFR Manual.docx

US Municipal CAFR Taxonomy

Proposed XBRL taxonomy for audited financial statements produced by US state and local governments

About 30,000 US state and local governments produce audited financial statements each year. Because these financial reports typically appear in PDF format, they are difficult to analyze and compare. By tranisitioning from PDFs to machine readable disclosures, we can ultimately create a publicly accessible database of audited government financial statistics.

The proposed taxonomy in this repository is a first step in this transition. We offer it to the community of statement filers and consumers for review, comment and improvement.

Aside from the taxonomy itself, we have a sample Inline XBRL instance document based on the city of St. Petersburg, Florida's 2017 Comprehensive Annual Financial Report. Please note that this sample is NOT an official financial document of the City of St. Petersburg and should not be used for any financial analysis purpose.

The repository includes an Excel workbook with VBA code that can generate compliant XBRL instance documents. To unlock sheets in this workbook, please use password Micro#16Vista; to see and modify the VBA code use password daolpu@16#. There is also a docx file containing tagged footnotes that can be emedded in the instance document.

The taxonomy is based on a peer reviewed article published by Professors Neal Snow and Jacqueline Reck in the Journal of Information Systems in 2016. A draft of this article is freely available on the Social Science Research Network at The published article is available to journal subscibers or for purchase at

A copy of the taxonomy is also online at thereby allowing for validation of instance douments on Arelle or other XBRL platforms.

You can see previous advocacy of municipal CAFR XBRL from 2013 here and 2015 here.

For more information about this project, or to volunteer, please contact Marc Joffe at