ClinicalCodes
ICD-10 lookup, versioned and audit-ready.
ClinicalCodes is a secured, API-first backend for looking up US ICD-10 codes — diagnoses (ICD-10-CM) and procedures (ICD-10-PCS) — with the versioning and audit that real billing work demands. One API serves the React web app and any future mobile client, with point-in-time queries so you can always answer not just 'what is this code' but 'what was valid on the date of service.'
- ICD-10-CM + PCS
- Diagnoses & procedures
- Point-in-time
- Valid on the date of service
- API-first
- One backend, any client
The problem
ICD-10 code sets change every year, and a claim has to be coded against the edition that was in effect on the date of service — not today's. Most reference tools only show the current codes, licensing around code sets is a minefield, and there's rarely an audit trail explaining where a given description came from.
The solution
ClinicalCodes is built on public-domain CMS/CDC-NCHS data with release-based versioning and effective-date windows, so 'current' and 'valid on date X' are both first-class queries. Updates are never destructive — codes retire by absence in a new release rather than being deleted — every row traces back to the import batch that produced it, and results export cleanly to Excel or CSV. It's all fronted by one secured, subscription-gated API.
What it does
Fast code search
Look up ICD-10-CM diagnoses and ICD-10-PCS procedures instantly by code or description across the whole US code set.
Point-in-time lookup
Release-based annual editions with effective-date windows answer both 'current' and 'what was valid on the date of service.'
Non-destructive history
Codes retire by absence in a new release, never deletion, and description changes are tracked per release — the full history is always there.
Flexible export
Export search results and code sets to Excel or CSV, ready to drop into billing workflows and downstream systems.
Secured API-first
JWT access and refresh tokens, scopes, and per-token rate limits — one backend cleanly consumed by the web app or any mobile client.
Import audit trail
Every code row traces to the import batch that produced it — with the source file, content hash, and notes — for full provenance.
Built with
A modern, proven stack chosen for reliability and speed of delivery.
- ASP.NET Core Web API (.NET 8)
- Dapper
- SQL Server
- React 18 + Vite
- TypeScript
- JWT (access + refresh) auth
- Stripe
- ClosedXML (Excel export)
- OpenAPI / Swagger
Security & reliability
Engineered with the same discipline as regulated healthcare systems.
- JWT access + refresh tokens with scopes and per-token rate limits; paid endpoints verify live subscription status
- Public-domain CMS/CDC-NCHS data with no destructive updates — the full release history is preserved
- Every code row is traceable to its import batch (source file + content hash) for a complete audit trail
Want a product like ClinicalCodes for your business?
This is exactly the kind of secure, production-grade software I build — quickly and affordably. Let's talk about yours.