-
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?
See also: https://usgpo.github.io/innovation/resources/
Put in a citation, get a set of links: https://www.law.cornell.edu/rio/
Put in a citation, get 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
- Bulk data sets for bill text, status, summaries - https://www.govinfo.gov/developers
- GovInfo Link Service for bills - https://www.govinfo.gov/link-docs
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
- GovInfo Statute Compilations API - also in GovInfo Link Service
- GovInfo Public and Private Laws API - also in GovInfo Link Service
- GovInfo Statutes at Large API - also 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
- US Code titles and sections - GovInfo API & GovInfo Link Service
- JSON & XML API - Current and past text - individual changes back to ~2017 - eCFR.gov
- GovInfo API and Link Service - https://www.govinfo.gov/link-docs/ - Annual editions back to 1996
- 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
- Library of Congress collection of scans from 1936 to 1993 is probably available via LoC APIs.
- GovInfo Link Service - https://www.govinfo.gov/link-docs/
- 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.
- Individual document API - Regulations.gov
- Bulk data download - Regulations.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