{"id":35886050,"url":"https://github.com/cmsgov/beneficiary-fhir-data","last_synced_at":"2026-04-23T17:01:45.975Z","repository":{"id":37500877,"uuid":"203852942","full_name":"CMSgov/beneficiary-fhir-data","owner":"CMSgov","description":"An API designed to serve Medicare beneficiaries' demographic, enrollment, and claims data using the HL7® FHIR® Standard format.","archived":false,"fork":false,"pushed_at":"2026-01-28T21:25:54.000Z","size":169989,"stargazers_count":74,"open_issues_count":13,"forks_count":35,"subscribers_count":25,"default_branch":"master","last_synced_at":"2026-01-29T06:53:24.622Z","etag":null,"topics":["fhir","fhir-mapping-language","medicare"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"cc0-1.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/CMSgov.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2019-08-22T18:41:16.000Z","updated_at":"2026-01-28T17:08:26.000Z","dependencies_parsed_at":"2025-04-16T16:42:32.678Z","dependency_job_id":"76d4d091-9368-4d2f-992e-f60d8e842efd","html_url":"https://github.com/CMSgov/beneficiary-fhir-data","commit_stats":null,"previous_names":[],"tags_count":310,"template":false,"template_full_name":null,"purl":"pkg:github/CMSgov/beneficiary-fhir-data","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CMSgov%2Fbeneficiary-fhir-data","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CMSgov%2Fbeneficiary-fhir-data/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CMSgov%2Fbeneficiary-fhir-data/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CMSgov%2Fbeneficiary-fhir-data/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CMSgov","download_url":"https://codeload.github.com/CMSgov/beneficiary-fhir-data/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CMSgov%2Fbeneficiary-fhir-data/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29135916,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-05T21:59:57.939Z","status":"ssl_error","status_checked_at":"2026-02-05T21:59:57.628Z","response_time":65,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["fhir","fhir-mapping-language","medicare"],"created_at":"2026-01-08T20:18:34.264Z","updated_at":"2026-02-05T22:01:09.131Z","avatar_url":"https://github.com/CMSgov.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Beneficiary FHIR Data System (BFD)\n\n## About the Project\n\nThis project contains modules and documentation in support of the Beneficiary FHIR Data (BFD) Server.\nThe BFD Server is an API designed to serve Medicare beneficiaries' demographic, enrollment, and claims data using the [HL7® FHIR® Standard](https://www.hl7.org/fhir/overview.html) format.\n\n## Core Team\n\nAlthough this is a public repo, contributing to the BFD is for CMS-approved contributors only, not outside contributors.\nFor more information about our BFD teams, see [COMMUNITY.md](COMMUNITY.md)\n\n## Project Vision\n\nIt's the vision of this project to provide a comprehensive, performant, and trustworthy platform to transform the way that the CMS enterprise shares and uses data.\n\n## Agency Mission\n\nThis aligns with the overarching mission to enable the CMS Enterprise to drive innovation in data sharing so that beneficiaries and their healthcare partners have the data they need to make informed decisions about their healthcare.\n\n## Repo Structure\n\nThe high-level purpose and location of each piece of the project is listed below.\n\n* [apps](apps) - contains the source code for each of the deployed BFD applications\n  * Legacy (v1/v2) App\n    * [bfd-data-fda](apps/bfd-data-fda) - downloads FDA Drug code names into a resource used during BFD drug code name lookups\n    * [bfd-data-npi](apps/bfd-data-npi) - downloads CMS NPI (National Provider Identification) names into a resource used during BFD NPI lookups\n    * [bfd-db-migrator](apps/bfd-db-migrator) - application for safely applying schema updates and data migrations to the BFD database\n    * [bfd-model](apps/bfd-model) - contains data models used throughout the BFD project\n    * [bfd-pipeline](apps/bfd-pipeline) - application for loading claim data from the provider into the BFD database\n    * [bfd-server](apps/bfd-server) - application for serving the BFD database data in FHIR format to users via the BFD API\n    * [bfd-shared-test-utils](apps/bfd-shared-test-utils) - utilities shared across BFD projects used in testing\n    * [bfd-shared-utils](apps/bfd-shared-utils) - utilities shared across BFD projects used in the application code\n    * [utils](apps/utils) - non-application scripts used for testing, development, and database management\n  * v3 App\n    * [bfd-model-idr](apps/bfd-model-idr) - data models and synthetic data generation used for mapping IDR data\n    * [bfd-pipeline-idr](apps/bfd-pipeline-idr) - ETL pipeline for transforming and loading IDR data\n    * [bfd-server-ng](apps/bfd-server-ng) - New version of the BFD REST API, serving FHIR data\n    * [bfd-db-migrator-ng](apps/bfd-db-migrator-ng) - simple facade for running flyway migrations using maven\n* [insights](insights) - contains documentation and resources for maintaining BFD Insights, a platform using AWS Cloudwatch to provide analytics and metrics for BFD applications\n* [ops](ops) - contains the scripts and resources required for packaging and deploying BFD applications\n* [rfcs](docs/rfcs) - holds the archived and active RFC (Request for Comment) documents for BFD\n\n### v3 App Setup\n\nThe v3 app should be set up in the following order since they are dependent on each other\n(follow the READMEs listed in each directory):\n\n1. [bfd-model-idr](apps/bfd-model-idr)\n2. [bfd-pipeline-idr](apps/bfd-pipeline-idr)\n3. [bfd-server-ng](apps/bfd-server-ng)\n\n## Contributing\n\nMany useful guides, documentation items, and runbooks can be found on the [BFD Wiki](https://github.com/CMSgov/beneficiary-fhir-data/wiki), hosted in this repo.\n\nThis includes information about [making requests to bfd](https://github.com/CMSgov/beneficiary-fhir-data/wiki/Making-Requests-to-BFD), [synthetic data](https://github.com/CMSgov/beneficiary-fhir-data/wiki/Synthetic-Data-Guide), and more.\n\nThe [BFD Wiki](https://github.com/CMSgov/beneficiary-fhir-data/wiki) contains useful resources like the [development environment setup guide](https://github.com/CMSgov/beneficiary-fhir-data/wiki/Local-Environment-Setup-for-BFD-Development), [style guide](https://github.com/CMSgov/beneficiary-fhir-data/wiki/BFD-Code-Style-Guide), [runbooks](https://github.com/CMSgov/beneficiary-fhir-data/wiki/Runbooks) for various scenarios, and more.\n\n## Community Guidelines\n\nWe want to ensure a welcoming environment for all of our projects. Our staff follow the [18F Code of Conduct](https://github.com/18F/code-of-conduct/blob/master/code-of-conduct.md) and all contributors should do the same.\n\n## Feedback\n\nIf you have any questions feel free to reach out on the [#bfd](https://cmsgov.slack.com/archives/C010WDXAZFZ) channel in CMS slack!\n\n## Policies\n\n### Open Source Policy\n\nWe adhere to the [CMS Open Source\nPolicy](https://github.com/CMSGov/cms-open-source-policy). If you have any\nquestions, just [shoot us an email](mailto:opensource@cms.hhs.gov).\n\n### Security and Responsible Disclosure Policy\n\n_Submit a vulnerability:_ Vulnerability reports can be submitted through [Bugcrowd](https://bugcrowd.com/cms-vdp). Reports may be submitted anonymously. If you share contact information, we will acknowledge receipt of your report within 3 business days.\n\nFor more information about our Security, Vulnerability, and Responsible Disclosure Policies, see [SECURITY.md](SECURITY.md).\n\n### Software Bill of Materials (SBOM)\n\nA Software Bill of Materials (SBOM) is a formal record containing the details and supply chain relationships of various components used in building software.\n\nIn the spirit of [Executive Order 14028 - Improving the Nation’s Cyber Security](https://www.gsa.gov/technology/it-contract-vehicles-and-purchasing-programs/information-technology-category/it-security/executive-order-14028), a SBOM for this repository is provided here: \u003chttps://github.com/CMSgov/beneficiary-fhir-data/network/dependencies\u003e.\n\nFor more information and resources about SBOMs, visit: \u003chttps://www.cisa.gov/sbom\u003e.\n\n## Public domain\n\nThis project is in the public domain within the United States, and copyright and related rights in the work worldwide are waived through the [CC0 1.0 Universal public domain dedication](https://creativecommons.org/publicdomain/zero/1.0/) as indicated in [LICENSE](LICENSE).\n\nAll contributions to this project will be released under the CC0 dedication. By submitting a pull request or issue, you are agreeing to comply with this waiver of copyright interest.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcmsgov%2Fbeneficiary-fhir-data","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcmsgov%2Fbeneficiary-fhir-data","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcmsgov%2Fbeneficiary-fhir-data/lists"}