-
Notifications
You must be signed in to change notification settings - Fork 10
Federal policy structured data options
What are options for APIs, XML downloads, and structured permalinks for US federal policy documents, available from official government websites?
To add in: https://www.govinfo.gov/developers
See also: https://usgpo.github.io/innovation/resources/
Put in a citation, get out a set of links: https://www.law.cornell.edu/rio/
Put in a citation, get out a set of links: https://github.com/unitedstates/uslaw.link - https://uslaw.link/
Citation extractor: https://github.com/unitedstates/citation
- API for bills, summaries of bills, etc - Congress.gov
Documentation:
- Document Type Definition files - House of Representatives
- StatViewer, unique links to public law pages (PDFs embedded in page) - example: https://uscode.house.gov/statviewer.htm?volume=95&page=788 - House of Representatives - not sure if documented
- Statute Compilations - in GovInfo Link Service
- Public and Private Laws - in GovInfo Link Service
- Statutes at Large - in GovInfo Link Service
- Bulk XML downloads of public law - House of Representatives
- Pages at uscode.house.gov have permalinks to individual paragraphs - example: https://uscode.house.gov/view.xhtml?req=granuleid:USC-prelim-title42-section1320b-7&num=0&edition=prelim#substructure-location_d - documented on FAQ page
- JSON API - Documents, metadata, search - back to ~1994 - FederalRegister.gov
- Unique links (not sure if documented) - https://www.federalregister.gov/citation/##-FR-##### - FederalRegister.gov - partial info for documents, some back before 1994
- RIN data in XML - RegInfo.gov - not sure if documented - example: https://www.reginfo.gov/public/do/eAgendaViewRule?pubId=201210&RIN=0938-AR18&operation=OPERATION_EXPORT_XML (page where that's linked). Resources: XML reports for rules under review + Unified Agendas.
- Library of Congress collection of scans back to 1936 is probably available via LoC APIs.
- Individual document API - Regulations.gov
- Bulk data download - Regulations.gov
- JSON & XML API - Current and past text - back to ~2017 - eCFR.gov
I don't know of any APIs for this other than ours.
Please note that all pages on this GitHub wiki are draft working documents, not complete or polished.
Our software team puts non-sensitive technical documentation on this wiki to help us maintain a shared understanding of our work, including what we've done and why. As an open source project, this documentation is public in case anything in here is helpful to other teams, including anyone who may be interested in reusing our code for other projects.
For context, see the HHS Open Source Software plan (2016) and CMS Technical Reference Architecture section about Open Source Software, including Business Rule BR-OSS-13: "CMS-Released OSS Code Must Include Documentation Accessible to the Open Source Community".
For CMS staff and contractors: internal documentation on Enterprise Confluence (requires login).
- Federal policy structured data options
- Regulations
- Resources
- Statute
- Citation formats
- Export data
- Site homepage
- Content authoring
- Search
- Timeline
- Not built
- 2021
- Reg content sources
- Default content view
- System last updated behavior
- Paragraph indenting
- Content authoring workflow
- Browser support
- Focus in left nav submenu
- Multiple content views
- Content review workflow
- Wayfinding while reading content
- Display of rules and NPRMs in sidebar
- Empty states for supplemental content
- 2022
- 2023
- 2024
- Medicaid and CHIP regulations user experience
- Initial pilot research outline
- Comparative analysis
- Statute research
- Usability study SOP
- 2021
- 2022
- 2023-2024: 🔒 Dovetail (requires login)
- 🔒 Overview (requires login)
- Authentication and authorization
- Frontend caching
- Validation checklist
- Search
- Security tools
- Tests and linting
- Archive