# PayerPrice API

> Healthcare price transparency APIs providing real-time negotiated rates, provider information, and market benchmarks across the United States.

Docs: [https://api.payerprice.com/api/doc](https://api.payerprice.com/api/doc)
Full API docs (markdown): [https://api.payerprice.com/api/doc.md](https://api.payerprice.com/api/doc.md)
OpenAPI spec: [https://api.payerprice.com/openapi.json](https://api.payerprice.com/openapi.json)

## Authentication

All API requests require a Bearer token in the Authorization header:
`Authorization: Bearer YOUR_API_KEY`

## Pricing APIs

- [Market Benchmarks](https://api.payerprice.com/api/doc.md#post-apiv1marketbenchmarks): Market-level aggregate statistics (percentiles, averages, min/max) across geography, taxonomy, payer, and billing code filters
- [Provider Rates](https://api.payerprice.com/api/doc.md#post-apiv1providerrates): Provider-specific negotiated rates by NPI, TIN, or CCN for fee schedule retrieval
- [Hospital Rates](https://api.payerprice.com/api/doc.md#post-apiv1providerhospitalrates): Hospital-published rates from price transparency files

## Provider APIs

- [NPI Lookup](https://api.payerprice.com/api/doc.md#post-apiv1npis): Retrieve provider info by National Provider Identifier
- [NPI Search](https://api.payerprice.com/api/doc.md#post-apiv1npisearch): Fuzzy search providers by name, taxonomy, state, county, or entity type
- [TIN Lookup](https://api.payerprice.com/api/doc.md#post-apiv1tins): Retrieve provider info by Taxpayer Identification Number
- [TIN Search](https://api.payerprice.com/api/doc.md#post-apiv1tinsearch): Fuzzy search TINs by name, taxonomy, state, or TIN type

## Payer APIs

- [Payers](https://api.payerprice.com/api/doc.md#get-apiv1payers): List supported payers and available data periods
- [Payer Plans](https://api.payerprice.com/api/doc.md#post-apiv1payerplans): List normalized plan names for a payer