Zero-dependency Go client for the Real Dental Costs Open Data API · code MIT · data CC BY 4.0 · source on Codeberg · reference on pkg.go.dev
The API is a set of static JSON files published by the Real Dental Costs Data & Research Team. Every payload carries a meta block (licence, attribution, DOI, methodology) and a provenance block with basis (observed or estimated), modeled, confidence (0-100) and sample_n, so a program can tell a measured figure from an index-scaled estimate before displaying it.
| Endpoint | Content | Human-readable page |
|---|---|---|
/procedures.json | 12 procedures, national cash price ranges | US dental cost index |
/procedure/root-canal.json | 51-state low / average / high, confidence per state | Root canal cost by state |
/procedure/dentures.json | same table for full and partial dentures | Denture cost by state |
/procedure/dental-implant.json | implant price table (observed state averages) | Dental implant cost by state |
/state/{code}.json | Restorative Cost Index, affordability score, Medicaid dentist acceptance, all procedures | e.g. Texas |
/medicaid/{cdt}.json | Medicaid paid amount per claim line for 62 CDT codes, national and by state, 2018-2024 (HHS/CMS T-MSIS) | Medicaid dental coverage by state · dataset DOI 10.7910/DVN/7F2BZI |
go get codeberg.org/tresor2k/realdentalcosts-goc := realdentalcosts.NewClient(nil)
p, _ := c.Procedure(ctx, "root-canal")
tx, _ := p.StateFor("TX")
fmt.Println(p.National.AvgUSD, tx.LowUSD, tx.HighUSD, p.Provenance.Confidence)
m, _ := c.Medicaid(ctx, "D3330") // molar root canal
fmt.Println(m.National.PaidPerLineWAvg, m.CashBenchmark.RatioCashAvgToMedicaidPaid)
s, _ := c.State(ctx, "CA")
fmt.Println(s.RestorativeCostIndex.Value, s.Medicaid.PctDentistsAccepting)ErrNotFound is returned (wrapped) for unknown slugs, state codes or CDT codes; other non-2xx responses come back as *APIError. The client has no third-party dependencies and is tested offline against embedded JSON fixtures.
price_type: estimated_index) are national ranges scaled by each state's Restorative Cost Index — treat them as estimates; the API says so in basis_note.price_type: medicaid_paid) are paid amounts per claim line, not allowed amounts, fee-schedule rates or cash prices. Managed-care encounters may carry nominal paid amounts in some states — check quality_flag.meta.doi. The figures are pricing and market research, not medical advice; corrections are logged on the data corrections page.Maintained by the Real Dental Costs Data & Research Team. Issues and pull requests: codeberg.org/tresor2k/realdentalcosts-go/issues.