specification: FinOps Framework
specificationVersion: '1.0'
alignedWith:
  framework: FinOps Foundation Framework
  frameworkUrl: https://www.finops.org/framework/
  dataSpec: FOCUS
  dataSpecVersion: '1.3'
  dataSpecUrl: https://focus.finops.org/focus-specification/v1-3/
provider: Centers for Medicare and Medicaid Services
providerId: centers-for-medicare-and-medicaid-services
publisherName: Centers for Medicare and Medicaid Services
serviceCategory: API
created: '2026-05-04'
# Provenance stamped 2026-08-11: this artifact was written by the API Evangelist
# bulk sweep dated 2026-05-04, not harvested from the provider. See roadmap#35.
method: generated
modified: '2026-05-04'
tags:
  - BCDA
  - Blue Button
  - CMS
  - Claims
  - DPC
  - FHIR
  - Federal Government
  - Healthcare
  - Interoperability
  - Marketplace
  - Medicaid
  - Medicare
  - Open Data
  - Provider Data
  - Socrata
  - FinOps
  - Cost Management
  - FOCUS
description: FinOps framework definition for the Centers for Medicare and Medicaid Services API surface.
  Provides a FOCUS-aligned mapping for cost allocation, usage measurement, and unit-economics reporting
  across the provider's APIs.
principles:
  - name: Visibility
    description: Make API consumption costs visible to engineering, product, and finance teams in near
      real-time.
  - name: Allocation
    description: Tag every chargeable API call with the consuming team, environment, application, and
      feature so cost can be allocated.
  - name: Optimization
    description: Continuously evaluate request patterns, caching, batching, and tier selection to reduce
      cost per useful unit of work.
  - name: Accountability
    description: Establish budget owners and chargeback or showback flows for each consuming team.
domains:
  - name: Understand Usage and Cost
    capabilities:
      - Data Ingestion
      - Allocation
      - Reporting and Analytics
      - Anomaly Management
  - name: Quantify Business Value
    capabilities:
      - Planning and Estimating
      - Forecasting
      - Budgeting
      - Benchmarking
      - Unit Economics
  - name: Optimize Usage and Cost
    capabilities:
      - Architecting for Cloud
      - Rate Optimization
      - Workload Optimization
      - Cloud Sustainability
      - Licensing and SaaS
  - name: Manage the FinOps Practice
    capabilities:
      - FinOps Practice Operations
      - FinOps Education and Enablement
      - Invoicing and Chargeback
      - Onboarding Workloads
      - Intersecting Disciplines
billingModel:
  pricingCategory: Usage-Based
  billingFrequency: Monthly
  billingCurrency: USD
  chargeCategories:
    - Usage
    - Purchase
    - Tax
    - Credit
    - Adjustment
  chargeFrequency: Recurring
focusColumns:
  ServiceName: Centers for Medicare and Medicaid Services
  ServiceCategory: Developer Tools / API
  ProviderName: Centers for Medicare and Medicaid Services
  PublisherName: Centers for Medicare and Medicaid Services
  InvoiceIssuerName: Centers for Medicare and Medicaid Services
  PricingCategory: Usage-Based
  PricingUnit: request
  BillingCurrency: USD
  ChargeCategory: Usage
meters:
  - name: api_requests
    description: Count of billable API requests
    unit: request
    aggregation: sum
    dimensions:
      - api
      - endpoint
      - tier
      - region
      - consumer
  - name: data_egress
    description: Bytes returned over the network in API responses
    unit: GB
    aggregation: sum
    dimensions:
      - api
      - region
      - consumer
  - name: compute_seconds
    description: Server-side compute consumed by the request, where applicable
    unit: second
    aggregation: sum
    dimensions:
      - api
      - endpoint
      - tier
apis:
  - name: CMS Blue Button 2.0 API
    baseURL: https://api.bluebutton.cms.gov/v2/fhir/
    tags:
      - Blue Button
      - Claims
      - FHIR
      - Medicare
      - OAuth 2.0
      - Patient Access
    serviceName: CMS Blue Button 2.0 API
    serviceCategory: API
  - name: CMS Beneficiary Claims Data API (BCDA)
    baseURL: https://api.bcda.cms.gov/api/v2/
    tags:
      - ACO
      - BCDA
      - Bulk FHIR
      - Claims
      - Medicare
      - Shared Savings
    serviceName: CMS Beneficiary Claims Data API (BCDA)
    serviceCategory: API
  - name: CMS Data at the Point of Care (DPC) API
    baseURL: https://api.dpc.cms.gov/api/v1/
    tags:
      - Bulk FHIR
      - Claims
      - FFS
      - Point of Care
      - Providers
    serviceName: CMS Data at the Point of Care (DPC) API
    serviceCategory: API
  - name: CMS Socrata Open Data API (data.cms.gov)
    baseURL: https://data.cms.gov/data.json
    tags:
      - Datasets
      - Medicare
      - Open Data
      - Provider Data
      - SODA
      - Socrata
    serviceName: CMS Socrata Open Data API (data.cms.gov)
    serviceCategory: API
  - name: CMS Provider Data Catalog API (Care Compare)
    baseURL: https://data.cms.gov/provider-data/api/1/
    tags:
      - Care Compare
      - Dialysis Compare
      - Hospital Compare
      - Nursing Home Compare
      - Provider Data
      - Quality
    serviceName: CMS Provider Data Catalog API (Care Compare)
    serviceCategory: API
  - name: NPPES NPI Registry API
    baseURL: https://npiregistry.cms.hhs.gov/api/
    tags:
      - Credentialing
      - NPI
      - NPPES
      - Provider Identifier
      - Provider Registry
    serviceName: NPPES NPI Registry API
    serviceCategory: API
  - name: Healthcare.gov Marketplace API
    baseURL: https://marketplace.api.healthcare.gov/api/v1/
    tags:
      - ACA
      - Exchange
      - Marketplace
      - Plan Finder
      - QHP
    serviceName: Healthcare.gov Marketplace API
    serviceCategory: API
  - name: CMS Quality Payment Program (QPP) Measures API
    baseURL: ''
    tags:
      - MIPS
      - Measures
      - Quality
      - QPP
      - Value-Based
    serviceName: CMS Quality Payment Program (QPP) Measures API
    serviceCategory: API
  - name: Medicare Coverage Database (MCD) API
    baseURL: ''
    tags:
      - Coverage
      - LCD
      - MAC
      - NCD
      - Policy
    serviceName: Medicare Coverage Database (MCD) API
    serviceCategory: API
unitEconomics:
  - name: Cost per 1K Requests
    metric: billed_cost / (api_requests / 1000)
    target: TBD
  - name: Cost per Active Consumer
    metric: billed_cost / active_consumers
    target: TBD
maintainers:
  - FN: Kin Lane
    email: kin@apievangelist.com