Enable Banking API — Accounts Data

naftiko: 1.0.0-alpha2
info:
  label: Enable Banking API — Accounts Data
  description: 'Enable Banking — Accounts Data capability covering AIS retrieval of account details, balances,
    and transactions from authorized PSU accounts. Lead operation: Get Account Transactions.'
  tags:
  - EnableBanking
  - OpenBanking
  - PSD2
  - AIS
  - Accounts
  created: '2026-05-25'
  modified: '2026-05-25'
binds:
- namespace: env
  keys:
    ENABLE_BANKING_JWT: ENABLE_BANKING_JWT
capability:
  consumes:
  - type: http
    namespace: accounts-accounts-data
    baseUri: https://api.enablebanking.com
    description: Enable Banking Accounts data endpoints. Account details, balances, transactions.
    resources:
    - name: account-details
      path: /accounts/{account_id}/details
      operations:
      - name: getaccountdetails
        method: GET
        description: Get account details for an authorized account.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: account_id
          in: path
          type: string
          required: true
    - name: account-balances
      path: /accounts/{account_id}/balances
      operations:
      - name: getaccountbalances
        method: GET
        description: Get balances for an authorized account.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: account_id
          in: path
          type: string
          required: true
    - name: account-transactions
      path: /accounts/{account_id}/transactions
      operations:
      - name: getaccounttransactions
        method: GET
        description: Get transactions for an authorized account; supports date range and continuation key.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: account_id
          in: path
          type: string
          required: true
        - name: date_from
          in: query
          type: string
          required: false
        - name: date_to
          in: query
          type: string
          required: false
        - name: continuation_key
          in: query
          type: string
          required: false
        - name: strategy
          in: query
          type: string
          required: false
    - name: account-transaction
      path: /accounts/{account_id}/transactions/{transaction_id}
      operations:
      - name: getaccounttransaction
        method: GET
        description: Get transaction details by id.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: account_id
          in: path
          type: string
          required: true
        - name: transaction_id
          in: path
          type: string
          required: true
    authentication:
      type: bearer
      value: '{{env.ENABLE_BANKING_JWT}}'
      placement: header
  exposes:
  - type: rest
    namespace: accounts-accounts-data-rest
    port: 8080
    description: REST adapter for Enable Banking Accounts data.
    resources:
    - path: /v1/accounts/{account_id}/details
      name: account-details
      description: REST surface for account details.
      operations:
      - method: GET
        name: getaccountdetails
        description: Get account details.
        call: accounts-accounts-data.getaccountdetails
        with:
          account_id: rest.path.account_id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/accounts/{account_id}/balances
      name: account-balances
      description: REST surface for account balances.
      operations:
      - method: GET
        name: getaccountbalances
        description: Get account balances.
        call: accounts-accounts-data.getaccountbalances
        with:
          account_id: rest.path.account_id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/accounts/{account_id}/transactions
      name: account-transactions
      description: REST surface for account transactions.
      operations:
      - method: GET
        name: getaccounttransactions
        description: Get account transactions.
        call: accounts-accounts-data.getaccounttransactions
        with:
          account_id: rest.path.account_id
          date_from: rest.query.date_from
          date_to: rest.query.date_to
          continuation_key: rest.query.continuation_key
          strategy: rest.query.strategy
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/accounts/{account_id}/transactions/{transaction_id}
      name: account-transaction
      description: REST surface for a single account transaction.
      operations:
      - method: GET
        name: getaccounttransaction
        description: Get a single transaction.
        call: accounts-accounts-data.getaccounttransaction
        with:
          account_id: rest.path.account_id
          transaction_id: rest.path.transaction_id
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: accounts-accounts-data-mcp
    port: 9090
    transport: http
    description: MCP adapter for Enable Banking Accounts data.
    tools:
    - name: enable-banking-get-account-details
      description: Get details for an authorized PSU account.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: accounts-accounts-data.getaccountdetails
      with:
        account_id: tools.account_id
      outputParameters:
      - type: object
        mapping: $.
    - name: enable-banking-get-account-balances
      description: Get balances for an authorized PSU account.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: accounts-accounts-data.getaccountbalances
      with:
        account_id: tools.account_id
      outputParameters:
      - type: object
        mapping: $.
    - name: enable-banking-get-account-transactions
      description: List transactions for an authorized PSU account.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: accounts-accounts-data.getaccounttransactions
      with:
        account_id: tools.account_id
        date_from: tools.date_from
        date_to: tools.date_to
        continuation_key: tools.continuation_key
        strategy: tools.strategy
      outputParameters:
      - type: object
        mapping: $.
    - name: enable-banking-get-account-transaction
      description: Get a single transaction by id.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: accounts-accounts-data.getaccounttransaction
      with:
        account_id: tools.account_id
        transaction_id: tools.transaction_id
      outputParameters:
      - type: object
        mapping: $.