# PayerPrice API

> PayerPrice's healthcare price transparency APIs give you access to negotiated rates, provider information, and market benchmarks across the United States.

- Human-readable docs: [https://app.payerprice.com/api/doc](https://app.payerprice.com/api/doc)
- Markdown docs: [https://app.payerprice.com/api/doc.md](https://app.payerprice.com/api/doc.md)
- OpenAPI specification: [https://app.payerprice.com/openapi.json](https://app.payerprice.com/openapi.json)
- MCP server docs: [https://app.payerprice.com/mcp/doc.md](https://app.payerprice.com/mcp/doc.md)

## Base URL

`https://api.payerprice.com`

## Authentication

All API requests require an API key as a Bearer token in the `Authorization` header:

`Authorization: Bearer YOUR_API_KEY`

## Payer APIs

- `GET /api/v1/payers` - [List available payers](https://app.payerprice.com/api/doc.md#get-apiv1payers): Retrieve supported payers and available year/month source-data periods.
- `POST /api/v1/payer/plans` - [List plans for a payer](https://app.payerprice.com/api/doc.md#post-apiv1payerplans): Retrieve the list of normalized plan names for a given payer, ordered by frequency (most common first).

## Provider APIs

- `POST /api/v1/npis` - [Look up providers by NPI](https://app.payerprice.com/api/doc.md#post-apiv1npis): Retrieve provider information for one or more National Provider Identifiers (NPIs).
- `POST /api/v1/npiSearch` - [Search NPIs by name](https://app.payerprice.com/api/doc.md#post-apiv1npiSearch): Fuzzy search for NPIs by name or NPI.
- `POST /api/v1/ccns` - [Look up hospitals by CCN](https://app.payerprice.com/api/doc.md#post-apiv1ccns): Retrieve hospital information keyed by CMS Certification Number (CCN).
- `POST /api/v1/ccnSearch` - [Search hospitals by name or CCN](https://app.payerprice.com/api/doc.md#post-apiv1ccnSearch): Search hospitals by name or CCN, with optional state, category, and facility type filters.
- `POST /api/v1/tins` - [Look up providers by TIN](https://app.payerprice.com/api/doc.md#post-apiv1tins): Retrieve provider information for one or more Taxpayer Identification Numbers (TINs).
- `POST /api/v1/tinSearch` - [Search TINs by name](https://app.payerprice.com/api/doc.md#post-apiv1tinSearch): Search TINs by name or exact TIN value, with optional provider taxonomy, state, or TIN type (ein/npi) filters.

## Pricing APIs

- `POST /api/v1/market/benchmarks` - [Get market rate benchmarks](https://app.payerprice.com/api/doc.md#post-apiv1marketbenchmarks): Search for market-level aggregate statistics and benchmarks.
- `POST /api/v1/provider/rates` - [Get provider negotiated rates](https://app.payerprice.com/api/doc.md#post-apiv1providerrates): Search for published provider-specific negotiated rates by NPI, TIN, or CCN.