Stripe Treasury API — Treasury

naftiko: 1.0.0-alpha2
info:
  label: Stripe Treasury API — Treasury
  description: 'Stripe Treasury API — Treasury. 32 operations. Lead operation: Treasury. Self-contained Naftiko capability
    covering one Stripe business surface.'
  tags:
  - Stripe
  - Treasury
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    STRIPE_API_KEY: STRIPE_API_KEY
capability:
  consumes:
  - type: http
    namespace: treasury-treasury-2
    baseUri: https://api.stripe.com
    description: Stripe Treasury API — Treasury business capability. Self-contained, no shared references.
    resources:
    - name: v1-treasury-credit_reversals
      path: /v1/treasury/credit_reversals
      operations:
      - name: gettreasurycreditreversals
        method: GET
        description: <p>Returns a list of CreditReversals.</p>
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: ending_before
          in: query
          type: string
          description: A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list.
            For instance, if you make a list request and receive 100 ob
        - name: expand
          in: query
          type: array
          description: Specifies which fields in the response should be expanded.
        - name: financial_account
          in: query
          type: string
          description: Returns objects associated with this FinancialAccount.
          required: true
        - name: limit
          in: query
          type: integer
          description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default
            is 10.
        - name: received_credit
          in: query
          type: string
          description: Only return CreditReversals for the ReceivedCredit ID.
        - name: starting_after
          in: query
          type: string
          description: A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list.
            For instance, if you make a list request and receive 100 o
        - name: status
          in: query
          type: string
          description: Only return CreditReversals for a given status.
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: posttreasurycreditreversals
        method: POST
        description: <p>Reverses a ReceivedCredit and creates a CreditReversal object.</p>
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: v1-treasury-credit_reversals-credit_reversal
      path: /v1/treasury/credit_reversals/{credit_reversal}
      operations:
      - name: gettreasurycreditreversalscreditreversal
        method: GET
        description: <p>Retrieves the details of an existing CreditReversal by passing the unique CreditReversal ID from either
          the CreditReversal creation request or CreditReversal list</p>
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: credit_reversal
          in: path
          type: string
          required: true
        - name: expand
          in: query
          type: array
          description: Specifies which fields in the response should be expanded.
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: v1-treasury-debit_reversals
      path: /v1/treasury/debit_reversals
      operations:
      - name: gettreasurydebitreversals
        method: GET
        description: <p>Returns a list of DebitReversals.</p>
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: ending_before
          in: query
          type: string
          description: A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list.
            For instance, if you make a list request and receive 100 ob
        - name: expand
          in: query
          type: array
          description: Specifies which fields in the response should be expanded.
        - name: financial_account
          in: query
          type: string
          description: Returns objects associated with this FinancialAccount.
          required: true
        - name: limit
          in: query
          type: integer
          description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default
            is 10.
        - name: received_debit
          in: query
          type: string
          description: Only return DebitReversals for the ReceivedDebit ID.
        - name: resolution
          in: query
          type: string
          description: Only return DebitReversals for a given resolution.
        - name: starting_after
          in: query
          type: string
          description: A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list.
            For instance, if you make a list request and receive 100 o
        - name: status
          in: query
          type: string
          description: Only return DebitReversals for a given status.
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: posttreasurydebitreversals
        method: POST
        description: <p>Reverses a ReceivedDebit and creates a DebitReversal object.</p>
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: v1-treasury-debit_reversals-debit_reversal
      path: /v1/treasury/debit_reversals/{debit_reversal}
      operations:
      - name: gettreasurydebitreversalsdebitreversal
        method: GET
        description: <p>Retrieves a DebitReversal object.</p>
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: debit_reversal
          in: path
          type: string
          required: true
        - name: expand
          in: query
          type: array
          description: Specifies which fields in the response should be expanded.
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: v1-treasury-financial_accounts
      path: /v1/treasury/financial_accounts
      operations:
      - name: gettreasuryfinancialaccounts
        method: GET
        description: <p>Returns a list of FinancialAccounts.</p>
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: created
          in: query
          type: string
        - name: ending_before
          in: query
          type: string
          description: An object ID cursor for use in pagination.
        - name: expand
          in: query
          type: array
          description: Specifies which fields in the response should be expanded.
        - name: limit
          in: query
          type: integer
          description: A limit ranging from 1 to 100 (defaults to 10).
        - name: starting_after
          in: query
          type: string
          description: An object ID cursor for use in pagination.
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: posttreasuryfinancialaccounts
        method: POST
        description: <p>Creates a new FinancialAccount. For now, each connected account can only have one FinancialAccount.</p>
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: v1-treasury-financial_accounts-financial_account
      path: /v1/treasury/financial_accounts/{financial_account}
      operations:
      - name: gettreasuryfinancialaccountsfinancialaccount
        method: GET
        description: <p>Retrieves the details of a FinancialAccount.</p>
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: expand
          in: query
          type: array
          description: Specifies which fields in the response should be expanded.
        - name: financial_account
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: posttreasuryfinancialaccountsfinancialaccount
        method: POST
        description: <p>Updates the details of a FinancialAccount.</p>
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: financial_account
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: v1-treasury-financial_accounts-financial_account-features
      path: /v1/treasury/financial_accounts/{financial_account}/features
      operations:
      - name: gettreasuryfinancialaccountsfinancialaccountfeatures
        method: GET
        description: <p>Retrieves Features information associated with the FinancialAccount.</p>
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: expand
          in: query
          type: array
          description: Specifies which fields in the response should be expanded.
        - name: financial_account
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: posttreasuryfinancialaccountsfinancialaccountfeatures
        method: POST
        description: <p>Updates the Features associated with a FinancialAccount.</p>
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: financial_account
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: v1-treasury-inbound_transfers
      path: /v1/treasury/inbound_transfers
      operations:
      - name: gettreasuryinboundtransfers
        method: GET
        description: <p>Returns a list of InboundTransfers sent from the specified FinancialAccount.</p>
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: ending_before
          in: query
          type: string
          description: A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list.
            For instance, if you make a list request and receive 100 ob
        - name: expand
          in: query
          type: array
          description: Specifies which fields in the response should be expanded.
        - name: financial_account
          in: query
          type: string
          description: Returns objects associated with this FinancialAccount.
          required: true
        - name: limit
          in: query
          type: integer
          description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default
            is 10.
        - name: starting_after
          in: query
          type: string
          description: A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list.
            For instance, if you make a list request and receive 100 o
        - name: status
          in: query
          type: string
          description: 'Only return InboundTransfers that have the given status: `processing`, `succeeded`, `failed` or `canceled`.'
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: posttreasuryinboundtransfers
        method: POST
        description: <p>Creates an InboundTransfer.</p>
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: v1-treasury-inbound_transfers-id
      path: /v1/treasury/inbound_transfers/{id}
      operations:
      - name: gettreasuryinboundtransfersid
        method: GET
        description: <p>Retrieves the details of an existing InboundTransfer.</p>
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: expand
          in: query
          type: array
          description: Specifies which fields in the response should be expanded.
        - name: id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: v1-treasury-inbound_transfers-inbound_transfer-cancel
      path: /v1/treasury/inbound_transfers/{inbound_transfer}/cancel
      operations:
      - name: posttreasuryinboundtransfersinboundtransfercancel
        method: POST
        description: <p>Cancels an InboundTransfer.</p>
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: inbound_transfer
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: v1-treasury-outbound_payments
      path: /v1/treasury/outbound_payments
      operations:
      - name: gettreasuryoutboundpayments
        method: GET
        description: <p>Returns a list of OutboundPayments sent from the specified FinancialAccount.</p>
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: customer
          in: query
          type: string
          description: Only return OutboundPayments sent to this customer.
        - name: ending_before
          in: query
          type: string
          description: A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list.
            For instance, if you make a list request and receive 100 ob
        - name: expand
          in: query
          type: array
          description: Specifies which fields in the response should be expanded.
        - name: financial_account
          in: query
          type: string
          description: Returns objects associated with this FinancialAccount.
          required: true
        - name: limit
          in: query
          type: integer
          description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default
            is 10.
        - name: starting_after
          in: query
          type: string
          description: A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list.
            For instance, if you make a list request and receive 100 o
        - name: status
          in: query
          type: string
          description: 'Only return OutboundPayments that have the given status: `processing`, `failed`, `posted`, `returned`,
            or `canceled`.'
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: posttreasuryoutboundpayments
        method: POST
        description: <p>Creates an OutboundPayment.</p>
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: v1-treasury-outbound_payments-id
      path: /v1/treasury/outbound_payments/{id}
      operations:
      - name: gettreasuryoutboundpaymentsid
        method: GET
        description: <p>Retrieves the details of an existing OutboundPayment by passing the unique OutboundPayment ID from
          either the OutboundPayment creation request or OutboundPayment list.</p>
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: expand
          in: query
          type: array
          description: Specifies which fields in the response should be expanded.
        - name: id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: v1-treasury-outbound_payments-id-cancel
      path: /v1/treasury/outbound_payments/{id}/cancel
      operations:
      - name: posttreasuryoutboundpaymentsidcancel
        method: POST
        description: <p>Cancel an OutboundPayment.</p>
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: v1-treasury-outbound_transfers
      path: /v1/treasury/outbound_transfers
      operations:
      - name: gettreasuryoutboundtransfers
        method: GET
        description: <p>Returns a list of OutboundTransfers sent from the specified FinancialAccount.</p>
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: ending_before
          in: query
          type: string
          description: A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list.
            For instance, if you make a list request and receive 100 ob
        - name: expand
          in: query
          type: array
          description: Specifies which fields in the response should be expanded.
        - name: financial_account
          in: query
          type: string
          description: Returns objects associated with this FinancialAccount.
          required: true
        - name: limit
          in: query
          type: integer
          description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default
            is 10.
        - name: starting_after
          in: query
          type: string
          description: A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list.
            For instance, if you make a list request and receive 100 o
        - name: status
          in: query
          type: string
          description: 'Only return OutboundTransfers that have the given status: `processing`, `canceled`, `failed`, `posted`,
            or `returned`.'
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: posttreasuryoutboundtransfers
        method: POST
        description: <p>Creates an OutboundTransfer.</p>
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: v1-treasury-outbound_transfers-outbound_transfer
      path: /v1/treasury/outbound_transfers/{outbound_transfer}
      operations:
      - name: gettreasuryoutboundtransfersoutboundtransfer
        method: GET
        description: <p>Retrieves the details of an existing OutboundTransfer by passing the unique OutboundTransfer ID from
          either the OutboundTransfer creation request or OutboundTransfer list.</p>
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: expand
          in: query
          type: array
          description: Specifies which fields in the response should be expanded.
        - name: outbound_transfer
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: v1-treasury-outbound_transfers-outbound_transfer-cancel
      path: /v1/treasury/outbound_transfers/{outbound_transfer}/cancel
      operations:
      - name: posttreasuryoutboundtransfersoutboundtransfercancel
        method: POST
        description: <p>An OutboundTransfer can be canceled if the funds have not yet been paid out.</p>
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: outbound_transfer
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: v1-treasury-received_credits
      path: /v1/treasury/received_credits
      operations:
      - name: gettreasuryreceivedcredits
        method: GET
        description: <p>Returns a list of ReceivedCredits.</p>
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: ending_before
          in: query
          type: string
          description: A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list.
            For instance, if you make a list request and receive 100 ob
        - name: expand
          in: query
          type: array
          description: Specifies which fields in the response should be expanded.
        - name: financial_account
          in: query
          type: string
          description: The FinancialAccount that received the funds.
          required: true
        - name: limit
          in: query
          type: integer
          description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default
            is 10.
        - name: linked_flows
          in: query
          type: object
          description: Only return ReceivedCredits described by the flow.
        - name: starting_after
          in: query
          type: string
          description: A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list.
            For instance, if you make a list request and receive 100 o
        - name: status
          in: query
          type: string
          description: 'Only return ReceivedCredits that have the given status: `succeeded` or `failed`.'
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: v1-treasury-received_credits-id
      path: /v1/treasury/received_credits/{id}
      operations:
      - name: gettreasuryreceivedcreditsid
        method: GET
        description: <p>Retrieves the details of an existing ReceivedCredit by passing the unique ReceivedCredit ID from the
          ReceivedCredit list.</p>
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: expand
          in: query
          type: array
          description: Specifies which fields in the response should be expanded.
        - name: id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: v1-treasury-received_debits
      path: /v1/treasury/received_debits
      operations:
      - name: gettreasuryreceiveddebits
        method: GET
        description: <p>Returns a list of ReceivedDebits.</p>
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: ending_before
          in: query
          type: string
          description: A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list.
            For instance, if you make a list request and receive 100 ob
        - name: expand
          in: query
          type: array
          description: Specifies which fields in the response should be expanded.
        - name: financial_account
          in: query
          type: string
          description: The FinancialAccount that funds were pulled from.
          required: true
        - name: limit
          in: query
          type: integer
          description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default
            is 10.
        - name: starting_after
          in: query
          type: string
          description: A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list.
            For instance, if you make a list request and receive 100 o
        - name: status
          in: query
          type: string
          description: 'Only return ReceivedDebits that have the given status: `succeeded` or `failed`.'
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: v1-treasury-received_debits-id
      path: /v1/treasury/received_debits/{id}
      operations:
      - name: gettreasuryreceiveddebitsid
        method: GET
        description: <p>Retrieves the details of an existing ReceivedDebit by passing the unique ReceivedDebit ID from the
          ReceivedDebit list</p>
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: expand
          in: query
          type: array
          description: Specifies which fields in the response should be expanded.
        - name: id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: v1-treasury-transaction_entries
      path: /v1/treasury/transaction_entries
      operations:
      - name: gettreasurytransactionentries
        method: GET
        description: <p>Retrieves a list of TransactionEntry objects.</p>
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: created
          in: query
          type: string
        - name: effective_at
          in: query
          type: string
        - name: ending_before
          in: query
          type: string
          description: A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list.
            For instance, if you make a list request and receive 100 ob
        - name: expand
          in: query
          type: array
          description: Specifies which fields in the response should be expanded.
        - name: financial_account
          in: query
          type: string
          description: Returns objects associated with this FinancialAccount.
          required: true
        - name: limit
          in: query
          type: integer
          description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default
            is 10.
        - name: order_by
          in: query
          type: string
          description: The results are in reverse chronological order by `created` or `effective_at`. The default is `created`.
        - name: starting_after
          in: query
          type: string
          description: A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list.
            For instance, if you make a list request and receive 100 o
        - name: transaction
          in: query
          type: string
          description: Only return TransactionEntries associated with this Transaction.
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: v1-treasury-transaction_entries-id
      path: /v1/treasury/transaction_entries/{id}
      operations:
      - name: gettreasurytransactionentriesid
        method: GET
        description: <p>Retrieves a TransactionEntry object.</p>
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: expand
          in: query
          type: array
          description: Specifies which fields in the response should be expanded.
        - name: id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: v1-treasury-transactions
      path: /v1/treasury/transactions
      operations:
      - name: gettreasurytransactions
        method: GET
        description: <p>Retrieves a list of Transaction objects.</p>
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: created
          in: query
          type: string
        - name: ending_before
          in: query
          type: string
          description: A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list.
            For instance, if you make a list request and receive 100 ob
        - name: expand
          in: query
          type: array
          description: Specifies which fields in the response should be expanded.
        - name: financial_account
          in: query
          type: string
          description: Returns objects associated with this FinancialAccount.
          required: true
        - name: limit
          in: query
          type: integer
          description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default
            is 10.
        - name: order_by
          in: query
          type: string
          description: The results are in reverse chronological order by `created` or `posted_at`. The default is `created`.
        - name: starting_after
          in: query
          type: string
          description: A cursor for use in pagination. `starting_after` is an object ID that defines your pla

# --- truncated at 32 KB (68 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/stripe/refs/heads/main/capabilities/treasury-treasury-2.yaml