CMS — Centers for Medicare & Medicaid Services OAuth Scopes

OAuth 2.0 derived

CMS — Centers for Medicare & Medicaid Services publishes 5 OAuth 2.0 scopes via the authorizationCode flow. Scopes are the fine-grained permissions an application requests at authorization time to act against the CMS — Centers for Medicare & Medicaid Services API on a user’s behalf.

Tokens are issued from https://api.bluebutton.cms.gov/v2/o/token/.

This index is generated from the provider’s OpenAPI security definitions (and, where available, its documented scope reference) and refreshes on every APIs.io network build. Browse every provider’s scopes at scopes.apis.io.

HealthcareMedicareMedicaidFHIRBulk DataOpen DataGovernmentFederalClaimsInsuranceACAMarketplaceQuality
Scopes: 5 Flows: authorizationCode Method: derived

OAuth endpoints

Authorization URL
https://api.bluebutton.cms.gov/v2/o/authorize/
Token URL
https://api.bluebutton.cms.gov/v2/o/token/
Flows
authorizationCode

Scopes (5)

ScopeDescriptionFlows
patient/Coverage.read Read Coverage resources authorizationCode
patient/ExplanationOfBenefit.read Read ExplanationOfBenefit resources authorizationCode
patient/Patient.read Read Patient resource authorizationCode
profile OpenID profile claims authorizationCode
read

Source

OAuth Scopes

cms-gov-scopes.yml Raw ↑
generated: '2026-07-11'
method: derived
source: openapi/cms-gov-blue-button-2-openapi.yml
schemes:
- name: OAuth2
  source: openapi/cms-gov-blue-button-2-openapi.yml
  flows:
  - flow: authorizationCode
    authorizationUrl: https://api.bluebutton.cms.gov/v2/o/authorize/
    tokenUrl: https://api.bluebutton.cms.gov/v2/o/token/
scopes:
- scope: patient/Coverage.read
  description: Read Coverage resources
  flows:
  - authorizationCode
  sources:
  - openapi/cms-gov-blue-button-2-openapi.yml
- scope: patient/ExplanationOfBenefit.read
  description: Read ExplanationOfBenefit resources
  flows:
  - authorizationCode
  sources:
  - openapi/cms-gov-blue-button-2-openapi.yml
- scope: patient/Patient.read
  description: Read Patient resource
  flows:
  - authorizationCode
  sources:
  - openapi/cms-gov-blue-button-2-openapi.yml
- scope: profile
  description: OpenID profile claims
  flows:
  - authorizationCode
  sources:
  - openapi/cms-gov-blue-button-2-openapi.yml
- scope: read
  sources:
  - openapi/cms-gov-blue-button-2-openapi.yml