# RealDentalCosts::API

A minimal Raku client for the free, no-key JSON API published by
[Real Dental Costs](https://realdentalcosts.com/en/api/): U.S. dental
procedure price benchmarks by state, and Medicaid (T-MSIS) provider
payment data by CDT procedure code.

## Synopsis

```raku
use RealDentalCosts::API;

my %crown = procedure('dental-crown');
say %crown<national><low_usd>;

my %root-canal-medicaid = medicaid('D3330');
say %root-canal-medicaid<meta><license>;
```

## Installation

```
zef install RealDentalCosts::API
```

## Data & documentation

This module wraps the public endpoints described in the
[Real Dental Costs open data & API documentation](https://realdentalcosts.com/en/api/).
Some reference pages built on the same underlying dataset, for context on
the numbers the API returns:

- [Real Dental Costs open data & API](https://realdentalcosts.com/en/api/) — endpoint reference, response schema, and licensing terms.
- [Dentures cost by state (2026)](https://realdentalcosts.com/en/dentures/) — full vs. partial denture price benchmarks across all 50 states.
- [Root canal cost by state](https://realdentalcosts.com/en/root-canal/) — molar/premolar/anterior root canal pricing by state.
- [Dental implants cost by state](https://realdentalcosts.com/en/dental-implants/) — single-implant and full-mouth implant price ranges.
- [Medicaid dental coverage by state (T-MSIS)](https://realdentalcosts.com/en/medicaid-dental-coverage-by-state/) — adult Medicaid dental benefit and provider payment data derived from CMS T-MSIS.
- [Methodology & sources](https://realdentalcosts.com/en/methodology/) — how the underlying dataset is compiled, sourced, and updated.

## License

**Code**: Artistic-2.0 (this module).

**Data returned by the API**: CC BY 4.0, Real Dental Costs. Every JSON
response includes a `meta` block with the license URL, attribution string,
and dataset DOI — see the `meta.attribution` field before republishing any
numbers.

## Author

Real Dental Costs Data & Research Team
