Skip to content

Chapter Provider API (1.6.1)

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.

Download OpenAPI description
index.json
index.yaml
Overview
Chapter Support

support@getchapter.com

Languages
Servers
Mock server

https://providers.docs.askchapter.org/_mock/apis/

Production server

https://api2.askchapter.org/v2/

Staging server

https://api2.staging.askchapter.org/v2/

Providers

Locate providers based on geographic and semantic search inputs

Operations

Coverage

Query provider coverage by plan and NPI

Operations

Get provider coverage by plan and NPI

Request

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.

Security
bearerAuth
Bodyapplication/jsonrequired
contractYearintegerrequired

Contract year to query (e.g., 2023)

Example: 2023
bidIdsArray of stringsrequired

Medicare bid IDs for plan lookup

Example: ["H1234_001_000"]
npisArray of objects(NpiWithLocationsInput)required

List of NPIs and optional related location IDs

npis[].​npistringrequired
Example: "1234567890"
npis[].​locationIdsArray of strings
Example: ["loc_001","loc_002"]
curl -i -X POST \
  https://providers.docs.askchapter.org/_mock/apis/providers/coverage \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "contractYear": 2023,
    "bidIds": [
      "H1234_001_000"
    ],
    "npis": [
      {
        "npi": "1234567890",
        "locationIds": [
          "loc_001",
          "loc_002"
        ]
      }
    ]
  }'

Responses

Nested list of provider plan coverage results

Bodyapplication/jsonArray [
contractYearinteger
Example: 2023
bidIdstring
Example: "H1234_001_000"
providersArray of objects(PlanProviderCoverage)
]
Response
application/json
[
  {
    "contractYear": 2023,
    "bidId": "H1234_001_000",
    "providers": [ … ]
  }
]
Copyright © Memoir Inc. No rights reserved.