Skip to content

FHIR-IQ/ainpi-examples

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ainpi-examples

Usage examples for the AINPI audit of the CMS National Provider Directory.

Every example reads the canonical /api/v1/* contract served from ainpi.vercel.app. The contract is a static JSON shape documented in AINPI/frontend/src/lib/api-v1-types.ts; external consumers can rely on it.

What's here

Path What it shows
python/fetch_stats.py 10-line Python snippet that pulls /api/v1/stats.json and prints the site counters
python/fetch_finding.py Pulls one finding's JSON and prints its headline + numerator/denominator
duckdb/query_findings.sql DuckDB one-shot that reads all finding JSONs as a table and ranks by age
notebooks/quickstart.ipynb Jupyter notebook walking through the same queries with plots

Installing

git clone https://github.com/FHIR-IQ/ainpi-examples
cd ainpi-examples/python
pip install -r requirements.txt
python fetch_stats.py

Methodology

See ainpi.vercel.app/methodology for how the numbers are computed. Every finding in /api/v1/findings/* carries methodology_version and commit_sha so you can pin against a specific release.

License

Apache-2.0 — same as the parent AINPI repo. Examples are contributor-friendly; PRs welcome.

About

Usage examples for the AINPI audit of the CMS National Provider Directory — Python one-liners, DuckDB queries, notebooks. Reads https://ainpi.vercel.app/api/v1/*. Part of https://github.com/FHIR-IQ/AINPI.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages