CMS Beneficiary Claims Data API (BCDA)

# Harvested verbatim 2026-08-15 from https://raw.githubusercontent.com/CMSgov/bcda-app/main/swagger.json
# method: searched | Beneficiary Claims Data API, first-party CMSgov/bcda-app repo; contact bcapi@cms.hhs.gov
openapi: 3.0.1
info:
  title: Beneficiary Claims Data API
  description: 'The Beneficiary Claims Data API (BCDA) allows downloading of claims data in accordance with the FHIR Bulk
    Data Export specification.


    If you have a Client ID and Secret you can use this page to explore the API.  To do this:

    1. Click the green "Authorize" button below and enter your Client ID and secret in the Basic Authentication boxes.

    2. Request a bearer token from /auth/token

    3. Click the green "Authorize" button below and put "Bearer {YOUR_TOKEN}" in the bearer_token box.


    Until you click logout your token will be presented with every request made.  To make requests click on the

    "Try it out" button for the desired endpoint.'
  contact:
    email: bcapi@cms.hhs.gov
  license:
    name: Public Domain
    url: https://github.com/CMSgov/bcda-app/blob/main/LICENSE.md
  version: 1.0.0
servers: []
paths:
  /_auth:
    get:
      tags:
      - auth
      summary: Get details about auth
      description: Returns the auth provider that is currently being used. Note that this endpoint is **not** prefixed with
        the base path (e.g. /api/v1).
      operationId: getAuthInfo
      responses:
        '200':
          description: JSON object containing an auth_provider field
          content:
            application/json:
              schema:
                required:
                - auth_provider
                type: object
                properties:
                  auth_provider:
                    type: string
                    x-go-name: Version
  /_version:
    get:
      tags:
      - metadata
      summary: Get API version
      description: Returns the version of the API that is currently running. Note that this endpoint is **not** prefixed with
        the base path (e.g. /api/v1).
      operationId: getVersion
      responses:
        '200':
          description: JSON object containing a version field
          content:
            application/json:
              schema:
                required:
                - version
                type: object
                properties:
                  version:
                    type: string
                    x-go-name: Version
  /api/v1/Group/{groupId}/$export:
    get:
      tags:
      - group
      summary: Start FHIR STU3 data export job for the specified group identifier and resource type(s)
      description: "Initiates a job to collect data from the Beneficiary FHIR Data API for your ACO. The supported Group identifiers\
        \ are `all` and `runout`. The `all` identifier returns data for the group of all patients attributed to the requesting\
        \ ACO. The `runout` identifier returns claims runouts data. \n\nIf used when specifying `_since`: all claims data\
        \ which has been updated since the specified date will be returned for beneficiaries which have been attributed to\
        \ the ACO since before the specified date; and all historical claims data will be returned for beneficiaries which\
        \ have been newly attributed to the ACO since the specified date.\n\n"
      operationId: bulkGroupRequest
      parameters:
      - name: _type
        in: query
        description: 'Resource type(s) requested. When left empty, will return all available resource types. TODO: return
          resource types here?'
        style: form
        explode: false
        schema:
          type: array
          items:
            type: string
          x-go-name: ResourceType
        x-go-name: ResourceType
      - name: _since
        in: query
        description: Only include resource versions that were created at or after the given instant in time.  Format of string
          must align with the FHIR Instant datatype (i.e., `2020-02-13T08:00:00.000-05:00`)
        schema:
          type: string
          x-go-name: DateTime
        x-go-name: DateTime
      - name: Prefer
        in: header
        required: true
        schema:
          type: string
          enum:
          - respond-async
      - name: groupId
        in: path
        description: ID of group export
        required: true
        schema:
          type: string
          enum:
          - all
          - runout
          x-go-name: GroupID
        x-go-name: GroupID
      responses:
        '202':
          description: 'A data export job has been started successfully. '
          headers:
            Content-Location:
              description: Returns a URI to the jobs status endpoint, along with the job id. `/jobs/<jobId>`
              schema:
                type: string
          content: {}
        '400':
          description: Malformed request
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/OperationOutcomeResponse'
        '401':
          description: Unauthorized. The provided credentials are invalid for the requested resource.
          content: {}
        '429':
          description: Too many requests. A bulk export job of this resource type is already in progress for the ACO.
          content: {}
        '500':
          description: Internal Server Error. The body will contain a FHIR OperationOutcome resource in JSON format. https://www.hl7.org/fhir/operationoutcome.html
            Please refer to the body of the response for details.
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/OperationOutcomeResponse'
      security:
      - bearer_token: []
  /api/v1/Patient/$export:
    get:
      tags:
      - patient
      summary: Start FHIR STU3 data export job for the specified group identifier and resource type(s)
      description: "Initiates a job to collect data from the Beneficiary FHIR Data API for your ACO.  \n\nIf used when specifying\
        \ `_since`: all claims data which has been updated since the specified date will be returned for beneficiaries which\
        \ have been attributed to the ACO since before the specified date.\n\n"
      operationId: bulkPatientRequest
      parameters:
      - name: _type
        in: query
        description: Resource types requested
        style: form
        explode: false
        schema:
          type: array
          items:
            type: string
          x-go-name: ResourceType
        x-go-name: ResourceType
      - name: _since
        in: query
        description: Only include resource versions that were created at or after the given instant in time.  Format of string
          must align with the FHIR Instant datatype (i.e., `2020-02-13T08:00:00.000-05:00`)
        schema:
          type: string
          x-go-name: DateTime
        x-go-name: DateTime
      - name: Prefer
        in: header
        required: true
        schema:
          type: string
          enum:
          - respond-async
      responses:
        '202':
          description: 'A data export job has been started successfully. '
          headers:
            Content-Location:
              description: Returns a URI to the jobs status endpoint, along with the job id. `/jobs/<jobId>`
              schema:
                type: string
          content: {}
        '400':
          description: Malformed request
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/OperationOutcomeResponse'
        '401':
          description: Unauthorized. The provided credentials are invalid for the requested resource.
          content: {}
        '429':
          description: Too many requests. A bulk export job of this resource type is already in progress for the ACO.
          content: {}
        '500':
          description: 'Internal Server Error. '
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/OperationOutcomeResponse'
      security:
      - bearer_token: []
  /api/v1/attribution_status:
    get:
      tags:
      - attribution
      summary: Get attribution status
      description: Returns the status of the latest ingestion for attribution and claims runout files. The response will contain
        the attribution Type to identify which ingestion and a Timestamp for the last time it was updated.
      operationId: attributionStatus
      responses:
        '200':
          description: Successful request. Response will contain an attribution type(s) of `last_attribution_update`, `last_runout_update`
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AttributionFilesParam'
        '404':
          description: 'No attribution data was found. '
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OperationOutcomeResponse'
      security:
      - bearer_token: []
  /api/v1/jobs:
    get:
      tags:
      - job
      summary: Get job(s) by status
      description: "Returns the current statuses of all current and past export jobs, along with the original job request\
        \ url. Supported status types are: \n\n - Completed\n\n - Archived\n\n - Expired\n\n - Failed\n\n - FailedExpired\n\
        \n - In Progress\n\n - Pending\n\n - Cancelled\n\n - CancelledExpired\n\n If no status(s) is provided, all jobs will\
        \ be returned.\n\nNote on job status to fhir task resource status mapping:\nDue to the fhir task status field having\
        \ a smaller set of values, the following statuses will be set to different fhir values in the response\n\n - Archived,\
        \ Expired -> Completed\n\n - FailedExpired -> Failed\n\n - Pending -> In Progress\n\n - CancelledExpired -> Cancelled\n\
        \nThough the status name has been remapped the response will still only contain jobs pertaining to the provided job\
        \ status in the request."
      operationId: jobsStatus
      parameters:
      - name: _status
        in: query
        description: Job statuses requested
        style: form
        explode: false
        schema:
          type: array
          items:
            $ref: '#/components/schemas/JobStatus'
          x-go-name: Status
        x-go-name: Status
      responses:
        '200':
          description: JSON object containing statuses of all current and previously requested jobs. The body will contain
            a FHIR Bundle resource in JSON format https://www.hl7.org/fhir/bundle.html and FHIR Task resources for the Bundle
            entries in JSON format https://www.hl7.org/fhir/task.html
          headers:
            Body:
              schema:
                type: object
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/BundleResponse'
        '400':
          description: 'Malformed request; check URI and parameters are correct. The body will contain a FHIR OperationOutcome
            resource in JSON format: https://www.hl7.org/fhir/operationoutcome.html'
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/OperationOutcomeResponse'
        '401':
          description: 'Unauthorized. The provided credentials are invalid for the requested resource. The body will contain
            a FHIR OperationOutcome resource in JSON format: https://www.hl7.org/fhir/operationoutcome.html'
          content: {}
        '404':
          description: 'The requested path was not found. The body will contain a FHIR OperationOutcome resource in JSON format:
            https://www.hl7.org/fhir/operationoutcome.html'
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/OperationOutcomeResponse'
        '410':
          description: 'The requested resource is no longer available. Completed jobs expire after 24 hours; request the data
            again. The body will contain a FHIR OperationOutcome resource in JSON format: https://www.hl7.org/fhir/operationoutcome.html'
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/OperationOutcomeResponse'
        '500':
          description: 'An error occurred. The body will contain a FHIR OperationOutcome resource in JSON format: https://www.hl7.org/fhir/operationoutcome.html'
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/OperationOutcomeResponse'
      security:
      - bearer_token: []
  /api/v1/jobs/{jobId}:
    get:
      tags:
      - job
      summary: Get job status and file location(s)
      description: Returns the current status of an export job and ndjson file locations, if available. The file locations
        will be under `output` and any job processing that encountered errors will be written to _<...-error.ndjson>_ files
        and located under `errors`.
      operationId: jobStatus
      parameters:
      - name: jobId
        in: path
        description: ID of data export job
        required: true
        schema:
          type: integer
          format: int64
          x-go-name: JobID
        x-go-name: JobID
      responses:
        '200':
          description: Data export job has completed successfully. The response body will contain a JSON object providing
            metadata about the transaction.
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/BulkResponseBody'
        '202':
          description: Data export job is in progress.
          headers:
            X-Progress:
              description: The status of the job progress
              schema:
                type: string
          content: {}
        '400':
          description: Malformed request. The body will contain a FHIR OperationOutcome resource in JSON format. https://www.hl7.org/fhir/operationoutcome.html
            Please refer to the body of the response for details.
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/OperationOutcomeResponse'
        '401':
          description: Unauthorized. The provided credentials are invalid for the requested resource.
          content: {}
        '404':
          description: The requested path was not found. The body will contain a FHIR OperationOutcome resource in JSON format.
            https://www.hl7.org/fhir/operationoutcome.html
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/OperationOutcomeResponse'
        '410':
          description: The requested resource is no longer available. The body will contain a FHIR OperationOutcome resource
            in JSON format. https://www.hl7.org/fhir/operationoutcome.html
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/OperationOutcomeResponse'
      security:
      - bearer_token: []
    delete:
      tags:
      - job
      summary: Cancel a job
      description: Cancels a currently running job.
      operationId: deleteJob
      parameters:
      - name: jobId
        in: path
        description: ID of data export job
        required: true
        schema:
          type: integer
          format: int64
          x-go-name: JobID
        x-go-name: JobID
      responses:
        '202':
          description: The job has been cancelled. No data will be available for download.
          content: {}
        '400':
          description: There was a problem with the request. The body will contain a FHIR OperationOutcome resource in JSON
            format. https://www.hl7.org/fhir/operationoutcome.html
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/OperationOutcomeResponse'
        '401':
          description: Unauthorized. The provided credentials are invalid for the requested resource.
          content: {}
        '404':
          description: The requested path was not found. The body will contain a FHIR OperationOutcome resource in JSON format.
            https://www.hl7.org/fhir/operationoutcome.html
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/OperationOutcomeResponse'
        '410':
          description: The requested resource is no longer available. The body will contain a FHIR OperationOutcome resource
            in JSON format. https://www.hl7.org/fhir/operationoutcome.html
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/OperationOutcomeResponse'
      security:
      - bearer_token: []
  /api/v1/metadata:
    get:
      tags:
      - metadata
      summary: Get metadata
      description: Returns metadata about the API.
      operationId: metadata
      responses:
        '200':
          description: FHIR CapabilityStatement in JSON format
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CapabilityStatement'
  /api/v2/Group/{groupId}/$export:
    get:
      tags:
      - group
      summary: Start FHIR R4 data export job for the specified group identifier and resource type(s)
      description: "Initiates a job to collect data from the Beneficiary FHIR Data API for your ACO. The supported Group identifiers\
        \ are `all` and `runout`. The `all` identifier returns data for the group of all patients attributed to the requesting\
        \ ACO. The `runout` identifier returns claims runouts data. \n\nIf used when specifying `_since`: all claims data\
        \ which has been updated since the specified date will be returned for beneficiaries which have been attributed to\
        \ the ACO since before the specified date; and all historical claims data will be returned for beneficiaries which\
        \ have been newly attributed to the ACO since the specified date.\n\n"
      operationId: bulkGroupRequestV2
      parameters:
      - name: _type
        in: query
        description: 'Resource type(s) requested. When left empty, will return all available resource types. _Note_: Claim
          and ClaimResponse are only available to REACH ACOs.'
        required: true
        style: form
        explode: false
        schema:
          type: array
          items:
            type: string
            enum:
            - Coverage
            - Patient
            - ExplanationOfBenefit
            - Claim
            - ClaimResponse
          x-go-name: ResourceType
        x-go-name: ResourceType
      - name: _since
        in: query
        description: Only include resource versions that were created at or after the given instant in time.  Format of string
          must align with the FHIR Instant datatype (i.e., `2020-02-13T08:00:00.000-05:00`)
        schema:
          type: string
          x-go-name: DateTime
        x-go-name: DateTime
      - name: Prefer
        in: header
        required: true
        schema:
          type: string
          enum:
          - respond-async
      - name: groupId
        in: path
        description: ID of group export
        required: true
        schema:
          type: string
          enum:
          - all
          - runout
          x-go-name: GroupID
        x-go-name: GroupID
      responses:
        '202':
          description: 'A data export job has been started successfully. '
          headers:
            Content-Location:
              description: Returns a URI to the jobs status endpoint, along with the job id. `/jobs/<jobId>`
              schema:
                type: string
          content: {}
        '400':
          description: Malformed request
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/OperationOutcomeResponse'
        '401':
          description: Unauthorized. The provided credentials are invalid for the requested resource.
          content: {}
        '429':
          description: Too many requests. A bulk export job of this resource type is already in progress for the ACO.
          content: {}
        '500':
          description: Internal Server Error.
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/OperationOutcomeResponse'
      security:
      - bearer_token: []
  /api/v2/Patient/$export:
    get:
      tags:
      - patient
      summary: Start FHIR R4 data export job for the specified group identifier and resource type(s)
      description: "Initiates a job to collect data from the Beneficiary FHIR Data API for your ACO.  \n\nIf used when specifying\
        \ `_since`: all claims data which has been updated since the specified date will be returned for beneficiaries which\
        \ have been attributed to the ACO since before the specified date.\n\n"
      operationId: bulkPatientRequestv2
      parameters:
      - name: _type
        in: query
        description: Resource types requested
        style: form
        explode: false
        schema:
          type: array
          items:
            type: string
          x-go-name: ResourceType
        x-go-name: ResourceType
      - name: _since
        in: query
        description: Only include resource versions that were created at or after the given instant in time.  Format of string
          must align with the FHIR Instant datatype (i.e., `2020-02-13T08:00:00.000-05:00`)
        schema:
          type: string
          x-go-name: DateTime
        x-go-name: DateTime
      - name: Prefer
        in: header
        required: true
        schema:
          type: string
          enum:
          - respond-async
      responses:
        '202':
          description: 'A data export job has been started successfully. '
          headers:
            Content-Location:
              description: Returns a URI to the jobs status endpoint, along with the job id. `/jobs/<jobId>`
              schema:
                type: string
          content: {}
        '400':
          description: Malformed request
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/OperationOutcomeResponse'
        '401':
          description: Unauthorized. The provided credentials are invalid for the requested resource.
          content: {}
        '429':
          description: Too many requests. A bulk export job of this resource type is already in progress for the ACO.
          content: {}
        '500':
          description: 'Internal Server Error. '
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/OperationOutcomeResponse'
      security:
      - bearer_token: []
  /api/v2/attribution_status:
    get:
      tags:
      - attribution
      summary: Get attribution status
      description: Returns the status of the latest ingestion for attribution and claims runout files. The response will contain
        the attribution Type to identify which ingestion and a Timestamp for the last time it was updated.
      operationId: attributionStatusv2
      responses:
        '200':
          description: Successful request. Response will contain an attribution type(s) of `last_attribution_update`, `last_runout_update`
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AttributionFilesParam'
        '404':
          description: 'No attribution data was found. '
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OperationOutcomeResponse'
      security:
      - bearer_token: []
  /api/v2/jobs:
    get:
      tags:
      - job
      summary: Get job(s) by status
      description: "Returns the current statuses of all current and past export jobs, along with the original job request\
        \ url. Supported status types are: \n\n - Completed\n\n - Archived\n\n - Expired\n\n - Failed\n\n - FailedExpired\n\
        \n - In Progress\n\n - Pending\n\n - Cancelled\n\n - CancelledExpired\n\n If no status(s) is provided, all jobs will\
        \ be returned.\n\nNote on job status to fhir task resource status mapping:\nDue to the fhir task status field having\
        \ a smaller set of values, the following statuses will be set to different fhir values in the response\n\n - Archived,\
        \ Expired -> Completed\n\n - FailedExpired -> Failed\n\n - Pending -> In Progress\n\n - CancelledExpired -> Cancelled\n\
        \nThough the status name has been remapped the response will still only contain jobs pertaining to the provided job\
        \ status in the request."
      operationId: jobsStatusV2
      parameters:
      - name: _status
        in: query
        description: Job statuses requested
        style: form
        explode: false
        schema:
          type: array
          items:
            $ref: '#/components/schemas/JobStatus'
          x-go-name: Status
        x-go-name: Status
      responses:
        '200':
          description: JSON object containing statuses of all current and previously requested jobs. The body will contain
            a FHIR Bundle resource in JSON format https://www.hl7.org/fhir/bundle.html and FHIR Task resources for the Bundle
            entries in JSON format https://www.hl7.org/fhir/task.html
          headers:
            Body:
              schema:
                type: object
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/BundleResponse'
        '400':
          description: 'Malformed request; check URI and parameters are correct. The body will contain a FHIR OperationOutcome
            resource in JSON format: https://www.hl7.org/fhir/operationoutcome.html'
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/OperationOutcomeResponse'
        '401':
          description: 'Unauthorized. The provided credentials are invalid for the requested resource. The body will contain
            a FHIR OperationOutcome resource in JSON format: https://www.hl7.org/fhir/operationoutcome.html'
          content: {}
        '404':
          description: 'The requested path was not found. The body will contain a FHIR OperationOutcome resource in JSON format:
            https://www.hl7.org/fhir/operationoutcome.html'
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/OperationOutcomeResponse'
        '410':
          description: 'The requested resource is no longer available. Completed jobs expire after 24 hours; request the data
            again. The body will contain a FHIR OperationOutcome resource in JSON format: https://www.hl7.org/fhir/operationoutcome.html'
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/OperationOutcomeResponse'
        '500':
          description: 'An error occurred. The body will contain a FHIR OperationOutcome resource in JSON format: https://www.hl7.org/fhir/operationoutcome.html'
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/OperationOutcomeResponse'
      security:
      - bearer_token: []
  /api/v2/jobs/{jobId}:
    get:
      tags:
      - job
      summary: Get job status and file location(s)
      description: Returns the current status of an export job and ndjson file locations, if available. The file locations
        will be under `output` and any job processing that encountered errors will be written to _<...-error.ndjson>_ files
        and located under `errors`.
      operationId: jobStatusidv2
      parameters:
      - name: jobId
        in: path
        description: ID of data export job
        required: true
        schema:
          type: integer
          format: int64
          x-go-name: JobID
        x-go-name: JobID
      responses:
        '200':
          description: Data export job has completed successfully. The response body will contain a JSON object providing
            metadata about the transaction.
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/BulkResponseBody'
        '202':
          description: Data export job is in progress.
          headers:
            X-Progress:
              description: The status of the job progress
              schema:
                type: string
          content: {}
        '400':
          description: Malformed request. The body will contain a FHIR OperationOutcome resource in JSON format. https://www.hl7.org/fhir/operationoutcome.html
            Please refer to the body of the response for details.
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/OperationOutcomeResponse'
        '401':
          description: Unauthorized. The provided credentials are invalid for the requested resource.
          content: {}
        '404':
          description: The requested path was not found. The body will contain a FHIR OperationOutcome resource in JSON format.
            https://www.hl7.org/fhir/operationoutcome.html
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/OperationOutcomeResponse'
        '410':
          description: The requested resource is no longer available. The body will contain a FHIR OperationOutcome resource
            in JSON format. https://www.hl7.org/fhir/operationoutcome.html
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/OperationOutcomeResponse'
      security:
      - bearer_token: []
    delete:
      tags:
      - job
      summary: Cancel a job
      description: Cancels a currently running job.
      operationId: deleteJobv2
      parameters:
      - name: jobId
        in: path
        description: ID of data export job
        required: true
        schema:
          type: integer
          format: int64
          x-go-name: JobID
        x-go-name: JobID
      responses:
        '202':
          description: The job has been cancelled. No data will be available for download.
          content: {}
        '400':
          description: There was a problem with the request. The body will contain a FHIR OperationOutcome resource in JSON
            format. https://www.hl7.org/fhir/operationoutcome.html
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/OperationOutcomeResponse'
        '401':
          description: Unauthorized. The provided credentials are invalid for the requested resource.
          content: {}
        '404':
          description: The requested path was not found. The body will contain a FHIR OperationOutcome resource in JSON format.
            https://www.hl7.org/fhir/operationoutcome.html
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/OperationOutcomeResponse'
        '410':
          description: The requested resource is no longer available. The body will contain a FHIR OperationOutcome resource
            in JSON format. https://www.hl7.org/fhir/operationoutcome.html
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/OperationOutcomeResponse'
      security:
      - bearer_token: []
  /api/v2/metadata:
    get:
      tags:
      - metadata
      summary: Get metadata
      description: Returns metadata about the API.
      operationId: metadatav2
      responses:
        '200':
          description: FHIR CapabilityStatement in JSON format
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CapabilityStatement'
  /auth/token:
    post:
      tags:
      - auth
      summary: Get access token
      description: Verifies Basic authentication credentials, and returns

# --- truncated at 32 KB (104 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/cms/refs/heads/main/openapi/cms-bcda-openapi.yml