# Chapter Provider API

The Chapter Provider API gives you access to:

- Coverage information for provider-plan combinations
- Location-based provider search
- Specific provider location lookups

All endpoints require a valid bearer token. Contact support@getchapter.com to request credentials.


Version: 1.6.1

## Servers

Production server
```
https://api2.askchapter.org/v2
```

Staging server
```
https://api2.staging.askchapter.org/v2
```

## Security

### bearerAuth

Authenticate using a bearer token in the `Authorization` header. Example: `Authorization: Bearer YOUR_TOKEN_HERE`


Type: http
Scheme: bearer
Bearer Format: JWT

## Download OpenAPI description

[Chapter Provider API](https://providers.docs.askchapter.org/_spec/apis/index.yaml)

## Providers

Locate providers based on geographic and semantic search inputs

### Search providers

 - [POST /providers/search](https://providers.docs.askchapter.org/apis/providers/search.md): Search for providers using flexible location options and query string. Supports searching by provider name, hospital group, or other text combined with various location formats.


### Get metadata for a specific provider

 - [GET /providers/{npi}](https://providers.docs.askchapter.org/apis/providers/getprovider.md): Use this endpoint to retrieve metadata for a provider by NPI.


### Get all known locations for a specific provider

 - [GET /providers/{npi}/locations](https://providers.docs.askchapter.org/apis/providers/getproviderlocations.md): Use this endpoint to retrieve every known practice location for a provider by NPI.


## Coverage

Query provider coverage by plan and NPI

### Get provider coverage by plan and NPI

 - [POST /providers/coverage](https://providers.docs.askchapter.org/apis/coverage/getprovidercoverage.md): Returns a nested list of provider coverage results grouped by bid ID and NPI. Used to determine whether a provider participates in specific Medicare Advantage plans.