QA Certification Management OpenAPI Specification — QA Certification

naftiko: 1.0.0-alpha2
info:
  label: QA Certification Management OpenAPI Specification — QA Certification
  description: 'QA Certification. 4 operations. Lead operation: Exports Official QA Certification Data. Self-contained Naftiko capability covering one EPA business surface.'
  tags:
    - EPA
    - QA Certification
  created: '2026-05-29'
  modified: '2026-05-29'
binds:
  - namespace: env
    keys:
      EPA_APIKEY_KEY: EPA_APIKEY_KEY
capability:
  consumes:
    - type: http
      namespace: cam-qa-cert-qa-certification
      baseUri: https://api.epa.gov/easey
      description: QA Certification Management OpenAPI Specification — QA Certification business capability. Self-contained, no shared references.
      authentication:
        type: apikey
        key: x-api-key
        value: '{{env.EPA_APIKEY_KEY}}'
        placement: header
      resources:
        - name: qa-certification-mgmt-export
          path: /qa-certification-mgmt/export
          operations:
            - name: qACertificationControllerexport
              method: GET
              description: Exports Official QA Certification Data
              inputParameters:
                - name: facilityId
                  in: query
                  type: number
                  required: true
                  description: The Facility ID code assigned by the Department of Energy's Energy Information Administration. The Energy Information Administration Plant ID code is also referred to as the "ORIS code", "ORISPL code"
                - name: unitIds
                  in: query
                  type: array
                  required: false
                  description: Unique identifier for each unit at a facility.
                - name: stackPipeIds
                  in: query
                  type: array
                  required: false
                  description: This is the alphanumeric code assigned by a source to identify a multiple or common stack or pipe at which emissions are determined.
                - name: testSummaryIds
                  in: query
                  type: array
                  required: false
                  description: Unique identifier of a test summary record.
                - name: qaCertificationEventIds
                  in: query
                  type: array
                  required: false
                  description: Unique identifier of a QA certification event record.
                - name: testTypeCodes
                  in: query
                  type: array
                  required: false
                  description: Code used to identify test type or the type of test performed.
                - name: qaTestExtensionExemptionIds
                  in: query
                  type: array
                  required: false
                  description: Unique Id for variances from prescribed testing requirements or extensions to the normal QA testing schedule.
                - name: beginDate
                  in: query
                  type: string
                  required: false
                  description: Date in which information became effective or activity started.
                - name: endDate
                  in: query
                  type: string
                  required: false
                  description: End date for a given period of a unit's emissions.
                - name: reportedValuesOnly
                  in: query
                  type: boolean
                  required: false
                  description: reportedValuesOnly
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: qa-certification-mgmt-cert-events
          path: /qa-certification-mgmt/cert-events
          operations:
            - name: qACertificationControllergetFilteredCerts
              method: GET
              description: qACertificationControllergetFilteredCerts
              inputParameters:
                - name: orisCodes
                  in: query
                  type: array
                  required: true
                  description: Array of oris codes
                - name: monPlanIds
                  in: query
                  type: array
                  required: false
                  description: Array of configurations
                - name: quarters
                  in: query
                  type: array
                  required: false
                  description: Array of quarter abbreviations
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: qa-certification-mgmt-test-summary
          path: /qa-certification-mgmt/test-summary
          operations:
            - name: qACertificationControllergetFilteredTestSums
              method: GET
              description: qACertificationControllergetFilteredTestSums
              inputParameters:
                - name: orisCodes
                  in: query
                  type: array
                  required: true
                  description: Array of oris codes
                - name: monPlanIds
                  in: query
                  type: array
                  required: false
                  description: Array of configurations
                - name: quarters
                  in: query
                  type: array
                  required: false
                  description: Array of quarter abbreviations
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: qa-certification-mgmt-test-extension-exemption
          path: /qa-certification-mgmt/test-extension-exemption
          operations:
            - name: qACertificationControllergetFilteredTee
              method: GET
              description: qACertificationControllergetFilteredTee
              inputParameters:
                - name: orisCodes
                  in: query
                  type: array
                  required: true
                  description: Array of oris codes
                - name: monPlanIds
                  in: query
                  type: array
                  required: false
                  description: Array of configurations
                - name: quarters
                  in: query
                  type: array
                  required: false
                  description: Array of quarter abbreviations
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
  exposes:
    - type: rest
      namespace: cam-qa-cert-qa-certification-rest
      port: 8080
      description: REST adapter for QA Certification Management OpenAPI Specification — QA Certification. One Spectral-compliant resource per consumed operation, prefixed with /v1.
      resources:
        - path: /v1/qa-certification-mgmt/export
          name: qa-certification-mgmt-export
          description: REST surface for Exports Official QA Certification Data.
          operations:
            - method: GET
              name: qACertificationControllerexport
              description: Exports Official QA Certification Data
              call: cam-qa-cert-qa-certification.qACertificationControllerexport
              with:
                facilityId: rest.facilityId
                unitIds: rest.unitIds
                stackPipeIds: rest.stackPipeIds
                testSummaryIds: rest.testSummaryIds
                qaCertificationEventIds: rest.qaCertificationEventIds
                testTypeCodes: rest.testTypeCodes
                qaTestExtensionExemptionIds: rest.qaTestExtensionExemptionIds
                beginDate: rest.beginDate
                endDate: rest.endDate
                reportedValuesOnly: rest.reportedValuesOnly
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/qa-certification-mgmt/cert-events
          name: qa-certification-mgmt-cert-events
          description: REST surface for qACertificationControllergetFilteredCerts.
          operations:
            - method: GET
              name: qACertificationControllergetFilteredCerts
              description: qACertificationControllergetFilteredCerts
              call: cam-qa-cert-qa-certification.qACertificationControllergetFilteredCerts
              with:
                orisCodes: rest.orisCodes
                monPlanIds: rest.monPlanIds
                quarters: rest.quarters
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/qa-certification-mgmt/test-summary
          name: qa-certification-mgmt-test-summary
          description: REST surface for qACertificationControllergetFilteredTestSums.
          operations:
            - method: GET
              name: qACertificationControllergetFilteredTestSums
              description: qACertificationControllergetFilteredTestSums
              call: cam-qa-cert-qa-certification.qACertificationControllergetFilteredTestSums
              with:
                orisCodes: rest.orisCodes
                monPlanIds: rest.monPlanIds
                quarters: rest.quarters
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/qa-certification-mgmt/test-extension-exemption
          name: qa-certification-mgmt-test-extension-exemption
          description: REST surface for qACertificationControllergetFilteredTee.
          operations:
            - method: GET
              name: qACertificationControllergetFilteredTee
              description: qACertificationControllergetFilteredTee
              call: cam-qa-cert-qa-certification.qACertificationControllergetFilteredTee
              with:
                orisCodes: rest.orisCodes
                monPlanIds: rest.monPlanIds
                quarters: rest.quarters
              outputParameters:
                - type: object
                  mapping: $.
    - type: mcp
      namespace: cam-qa-cert-qa-certification-mcp
      port: 9090
      transport: http
      description: MCP adapter for QA Certification Management OpenAPI Specification — QA Certification. One tool per consumed operation, routed inline through this capability's consumes block.
      tools:
        - name: exports-official-qa-certification-data
          description: Exports Official QA Certification Data
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: cam-qa-cert-qa-certification.qACertificationControllerexport
          with:
            facilityId: tools.facilityId
            unitIds: tools.unitIds
            stackPipeIds: tools.stackPipeIds
            testSummaryIds: tools.testSummaryIds
            qaCertificationEventIds: tools.qaCertificationEventIds
            testTypeCodes: tools.testTypeCodes
            qaTestExtensionExemptionIds: tools.qaTestExtensionExemptionIds
            beginDate: tools.beginDate
            endDate: tools.endDate
            reportedValuesOnly: tools.reportedValuesOnly
          outputParameters:
            - type: object
              mapping: $.
        - name: qacertificationcontroller-getfilteredcerts
          description: qacertificationcontroller-getfilteredcerts
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: cam-qa-cert-qa-certification.qACertificationControllergetFilteredCerts
          with:
            orisCodes: tools.orisCodes
            monPlanIds: tools.monPlanIds
            quarters: tools.quarters
          outputParameters:
            - type: object
              mapping: $.
        - name: qacertificationcontroller-getfilteredtestsums
          description: qacertificationcontroller-getfilteredtestsums
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: cam-qa-cert-qa-certification.qACertificationControllergetFilteredTestSums
          with:
            orisCodes: tools.orisCodes
            monPlanIds: tools.monPlanIds
            quarters: tools.quarters
          outputParameters:
            - type: object
              mapping: $.
        - name: qacertificationcontroller-getfilteredtee
          description: qacertificationcontroller-getfilteredtee
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: cam-qa-cert-qa-certification.qACertificationControllergetFilteredTee
          with:
            orisCodes: tools.orisCodes
            monPlanIds: tools.monPlanIds
            quarters: tools.quarters
          outputParameters:
            - type: object
              mapping: $.