Lending — Transactions

naftiko: 1.0.0-alpha2
info:
  label: Lending — Transactions
  description: 'Lending — Transactions. 13 operations. Lead operation: List account transactions. Self-contained Naftiko capability
    covering one Codat business surface.'
  tags:
  - Codat
  - Transactions
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    CODAT_API_KEY: CODAT_API_KEY
capability:
  consumes:
  - type: http
    namespace: lending-transactions
    baseUri: https://api.codat.io
    description: Lending — Transactions business capability. Self-contained, no shared references.
    resources:
    - name: companies-companyId-connections-connectionId-data-accountTransactions
      path: /companies/{companyId}/connections/{connectionId}/data/accountTransactions
      operations:
      - name: listaccountingaccounttransactions
        method: GET
        description: List account transactions
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: companies-companyId-connections-connectionId-data-accountTransactions-accountTra
      path: /companies/{companyId}/connections/{connectionId}/data/accountTransactions/{accountTransactionId}
      operations:
      - name: getaccountingaccounttransaction
        method: GET
        description: Get account transaction
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: accountTransactionId
          in: path
          type: string
          description: Unique identifier for an account transaction.
          required: true
    - name: companies-companyId-connections-connectionId-data-directCosts
      path: /companies/{companyId}/connections/{connectionId}/data/directCosts
      operations:
      - name: listaccountingdirectcosts
        method: GET
        description: List direct costs
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: companies-companyId-connections-connectionId-data-directCosts-directCostId
      path: /companies/{companyId}/connections/{connectionId}/data/directCosts/{directCostId}
      operations:
      - name: getaccountingdirectcost
        method: GET
        description: Get direct cost
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: companies-companyId-connections-connectionId-data-directCosts-directCostId-attac
      path: /companies/{companyId}/connections/{connectionId}/data/directCosts/{directCostId}/attachments
      operations:
      - name: listaccountingdirectcostattachments
        method: GET
        description: List direct cost attachments
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: companies-companyId-connections-connectionId-data-directCosts-directCostId-attac
      path: /companies/{companyId}/connections/{connectionId}/data/directCosts/{directCostId}/attachments/{attachmentId}
      operations:
      - name: getaccountingdirectcostattachment
        method: GET
        description: Get direct cost attachment
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: companies-companyId-connections-connectionId-data-directCosts-directCostId-attac
      path: /companies/{companyId}/connections/{connectionId}/data/directCosts/{directCostId}/attachments/{attachmentId}/download
      operations:
      - name: downloadaccountingdirectcostattachment
        method: GET
        description: Download direct cost attachment
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: companies-companyId-connections-connectionId-data-transfers
      path: /companies/{companyId}/connections/{connectionId}/data/transfers
      operations:
      - name: listaccountingtransfers
        method: GET
        description: List transfers
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: companies-companyId-connections-connectionId-data-transfers-transferId
      path: /companies/{companyId}/connections/{connectionId}/data/transfers/{transferId}
      operations:
      - name: getaccountingtransfer
        method: GET
        description: Get transfer
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: companies-companyId-data-journalEntries
      path: /companies/{companyId}/data/journalEntries
      operations:
      - name: listaccountingjournalentries
        method: GET
        description: List journal entries
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: companies-companyId-data-journalEntries-journalEntryId
      path: /companies/{companyId}/data/journalEntries/{journalEntryId}
      operations:
      - name: getaccountingjournalentry
        method: GET
        description: Get journal entry
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: companies-companyId-data-journals
      path: /companies/{companyId}/data/journals
      operations:
      - name: listaccountingjournals
        method: GET
        description: List journals
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: companies-companyId-data-journals-journalId
      path: /companies/{companyId}/data/journals/{journalId}
      operations:
      - name: getaccountingjournal
        method: GET
        description: Get journal
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: journalId
          in: path
          type: string
          description: Unique identifier for a journal.
          required: true
    authentication:
      type: apikey
      key: Authorization
      value: '{{env.CODAT_API_KEY}}'
      placement: header
  exposes:
  - type: rest
    namespace: lending-transactions-rest
    port: 8080
    description: REST adapter for Lending — Transactions. One Spectral-compliant resource per consumed operation, prefixed
      with /v1.
    resources:
    - path: /v1/companies/{companyid}/connections/{connectionid}/data/accounttransactions
      name: companies-companyid-connections-connectionid-data-accounttransactions
      description: REST surface for companies-companyId-connections-connectionId-data-accountTransactions.
      operations:
      - method: GET
        name: listaccountingaccounttransactions
        description: List account transactions
        call: lending-transactions.listaccountingaccounttransactions
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/companies/{companyid}/connections/{connectionid}/data/accounttransactions/{accounttransactionid}
      name: companies-companyid-connections-connectionid-data-accounttransactions-accounttra
      description: REST surface for companies-companyId-connections-connectionId-data-accountTransactions-accountTra.
      operations:
      - method: GET
        name: getaccountingaccounttransaction
        description: Get account transaction
        call: lending-transactions.getaccountingaccounttransaction
        with:
          accountTransactionId: rest.accountTransactionId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/companies/{companyid}/connections/{connectionid}/data/directcosts
      name: companies-companyid-connections-connectionid-data-directcosts
      description: REST surface for companies-companyId-connections-connectionId-data-directCosts.
      operations:
      - method: GET
        name: listaccountingdirectcosts
        description: List direct costs
        call: lending-transactions.listaccountingdirectcosts
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/companies/{companyid}/connections/{connectionid}/data/directcosts/{directcostid}
      name: companies-companyid-connections-connectionid-data-directcosts-directcostid
      description: REST surface for companies-companyId-connections-connectionId-data-directCosts-directCostId.
      operations:
      - method: GET
        name: getaccountingdirectcost
        description: Get direct cost
        call: lending-transactions.getaccountingdirectcost
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/companies/{companyid}/connections/{connectionid}/data/directcosts/{directcostid}/attachments
      name: companies-companyid-connections-connectionid-data-directcosts-directcostid-attac
      description: REST surface for companies-companyId-connections-connectionId-data-directCosts-directCostId-attac.
      operations:
      - method: GET
        name: listaccountingdirectcostattachments
        description: List direct cost attachments
        call: lending-transactions.listaccountingdirectcostattachments
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/companies/{companyid}/connections/{connectionid}/data/directcosts/{directcostid}/attachments/{attachmentid}
      name: companies-companyid-connections-connectionid-data-directcosts-directcostid-attac
      description: REST surface for companies-companyId-connections-connectionId-data-directCosts-directCostId-attac.
      operations:
      - method: GET
        name: getaccountingdirectcostattachment
        description: Get direct cost attachment
        call: lending-transactions.getaccountingdirectcostattachment
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/companies/{companyid}/connections/{connectionid}/data/directcosts/{directcostid}/attachments/{attachmentid}/download
      name: companies-companyid-connections-connectionid-data-directcosts-directcostid-attac
      description: REST surface for companies-companyId-connections-connectionId-data-directCosts-directCostId-attac.
      operations:
      - method: GET
        name: downloadaccountingdirectcostattachment
        description: Download direct cost attachment
        call: lending-transactions.downloadaccountingdirectcostattachment
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/companies/{companyid}/connections/{connectionid}/data/transfers
      name: companies-companyid-connections-connectionid-data-transfers
      description: REST surface for companies-companyId-connections-connectionId-data-transfers.
      operations:
      - method: GET
        name: listaccountingtransfers
        description: List transfers
        call: lending-transactions.listaccountingtransfers
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/companies/{companyid}/connections/{connectionid}/data/transfers/{transferid}
      name: companies-companyid-connections-connectionid-data-transfers-transferid
      description: REST surface for companies-companyId-connections-connectionId-data-transfers-transferId.
      operations:
      - method: GET
        name: getaccountingtransfer
        description: Get transfer
        call: lending-transactions.getaccountingtransfer
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/companies/{companyid}/data/journalentries
      name: companies-companyid-data-journalentries
      description: REST surface for companies-companyId-data-journalEntries.
      operations:
      - method: GET
        name: listaccountingjournalentries
        description: List journal entries
        call: lending-transactions.listaccountingjournalentries
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/companies/{companyid}/data/journalentries/{journalentryid}
      name: companies-companyid-data-journalentries-journalentryid
      description: REST surface for companies-companyId-data-journalEntries-journalEntryId.
      operations:
      - method: GET
        name: getaccountingjournalentry
        description: Get journal entry
        call: lending-transactions.getaccountingjournalentry
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/companies/{companyid}/data/journals
      name: companies-companyid-data-journals
      description: REST surface for companies-companyId-data-journals.
      operations:
      - method: GET
        name: listaccountingjournals
        description: List journals
        call: lending-transactions.listaccountingjournals
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/companies/{companyid}/data/journals/{journalid}
      name: companies-companyid-data-journals-journalid
      description: REST surface for companies-companyId-data-journals-journalId.
      operations:
      - method: GET
        name: getaccountingjournal
        description: Get journal
        call: lending-transactions.getaccountingjournal
        with:
          journalId: rest.journalId
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: lending-transactions-mcp
    port: 9090
    transport: http
    description: MCP adapter for Lending — Transactions. One tool per consumed operation, routed inline through this capability's
      consumes block.
    tools:
    - name: list-account-transactions
      description: List account transactions
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: lending-transactions.listaccountingaccounttransactions
      outputParameters:
      - type: object
        mapping: $.
    - name: get-account-transaction
      description: Get account transaction
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: lending-transactions.getaccountingaccounttransaction
      with:
        accountTransactionId: tools.accountTransactionId
      outputParameters:
      - type: object
        mapping: $.
    - name: list-direct-costs
      description: List direct costs
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: lending-transactions.listaccountingdirectcosts
      outputParameters:
      - type: object
        mapping: $.
    - name: get-direct-cost
      description: Get direct cost
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: lending-transactions.getaccountingdirectcost
      outputParameters:
      - type: object
        mapping: $.
    - name: list-direct-cost-attachments
      description: List direct cost attachments
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: lending-transactions.listaccountingdirectcostattachments
      outputParameters:
      - type: object
        mapping: $.
    - name: get-direct-cost-attachment
      description: Get direct cost attachment
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: lending-transactions.getaccountingdirectcostattachment
      outputParameters:
      - type: object
        mapping: $.
    - name: download-direct-cost-attachment
      description: Download direct cost attachment
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: lending-transactions.downloadaccountingdirectcostattachment
      outputParameters:
      - type: object
        mapping: $.
    - name: list-transfers
      description: List transfers
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: lending-transactions.listaccountingtransfers
      outputParameters:
      - type: object
        mapping: $.
    - name: get-transfer
      description: Get transfer
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: lending-transactions.getaccountingtransfer
      outputParameters:
      - type: object
        mapping: $.
    - name: list-journal-entries
      description: List journal entries
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: lending-transactions.listaccountingjournalentries
      outputParameters:
      - type: object
        mapping: $.
    - name: get-journal-entry
      description: Get journal entry
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: lending-transactions.getaccountingjournalentry
      outputParameters:
      - type: object
        mapping: $.
    - name: list-journals
      description: List journals
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: lending-transactions.listaccountingjournals
      outputParameters:
      - type: object
        mapping: $.
    - name: get-journal
      description: Get journal
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: lending-transactions.getaccountingjournal
      with:
        journalId: tools.journalId
      outputParameters:
      - type: object
        mapping: $.