overlay: 1.0.0
info:
  title: Citizens Statements (FDX v2.1, sandbox) API enrichment overlay
  version: 1.0.0
  x-generated: '2026-09-05'
  x-method: generated
  x-source: API Evangelist enrichment pass 2026-09-05; every value is read from the harvested contract
    itself or from a Citizens-published page named in the action description.
extends: citizens-financial-group-statements-v2-openapi.yml
actions:
- target: $.info
  description: Record the harvest provenance and the portal page the contract was read from.
  update:
    x-apis-io-harvested: '2026-09-05'
    x-apis-io-source: https://sandboxdeveloper.citizensbank.com/product/statements/api/statements-v2
    x-apis-io-environment: sandbox
- target: $.info
  description: Name the domain standard and record the version skew against production.
  update:
    x-domain-standard:
      id: fdx
      name: Financial Data Exchange (FDX) API
      version: '2.1'
      declared-at: $.basePath
      see: conformance/citizens-financial-group-conformance.yml
    x-version-skew:
      sandbox: FDX v2.1 (this contract, Statements 2.0.5)
      production: FDX v1.0 (Statements 1.0.7, https://api.citizensbank.com/fdx/v1.0)
      note: Citizens publishes no migration note explaining the gap between the two.
      see: lifecycle/citizens-financial-group-lifecycle.yml
- target: $.paths['/accounts/{accountId}/statements'].get
  description: Supply a stable identifier for the statement list; the published contract declares none.
  update:
    tags:
    - Statements
    x-apis-io-operation-id: listAccountStatements
    x-apis-io-operation-id-source: assigned by API Evangelist; the published contract declares none
- target: $.paths['/accounts/{accountId}/statements/{statementId}'].get
  description: Supply a stable identifier for the single-statement read.
  update:
    tags:
    - Statements
    x-apis-io-operation-id: getAccountStatement
    x-apis-io-operation-id-source: assigned by API Evangelist; the published contract declares none
- target: $
  description: Record the mandatory sandbox stage and the error-contract gap.
  update:
    x-sandbox:
      mandatory: true
      portal: https://sandboxdeveloper.citizensbank.com/
      see: sandbox/citizens-financial-group-sandbox.yml
    x-error-contract-gap:
      declared-status-codes:
      - '200'
      note: No 4xx or 5xx response is declared on any operation in this contract.
      see: errors/citizens-financial-group-error-codes.yml