Bank fees

Bank fees in Sage Intacct are financial transactions that capture charges or incentives incurred in connection with bank account activity.

For more information, read about bank interest and charges in the Sage Intacct Help Center.

List bank fees

get/objects/cash-management/bank-fee

Returns a collection with a key, ID, and link for each bank fee. This operation is mostly for use in testing; use the query service to find objects that meet certain criteria and to specify properties that are returned.

SecurityOAuth2
Responses
200

OK

400

Bad Request

Request samples 
Response samples 
application/json
{
  • "ia::result": [
    • {
      • "key": "1718",
      • "id": "1718",
      • "href": "/objects/cash-management/bank-fee/1718"
      },
    • {
      • "key": "1717",
      • "id": "1717",
      • "href": "/objects/cash-management/bank-fee/1717"
      },
    • {
      • "key": "3228",
      • "id": "3228",
      • "href": "/objects/cash-management/bank-fee/3228"
      }
    ],
  • "ia::meta": {
    • "totalCount": 3,
    • "start": 1,
    • "pageSize": 100,
    • "next": null,
    • "previous": null
    }
}
Create a bank fee
post/objects/cash-management/bank-fee
Creates a new bank fee transaction.


SecurityOAuth2 
Request 
Request Body schema: application/json
required
txnDate
required
string <date> 
Date when the bank fee transaction occurred.


 
 Example:  "2024-01-23"
txnType
required
string
Indicates whether this bank fee transaction is interest earned or a service charge.


 Enum: "interestEarned" "serviceCharge"  
 Example:  "serviceCharge"
required
object
Bank account in which to record the service charge or interest earned.


 
key
string
Unique key for the bank account.


 
 Example:  "1"
id
string
Identifier for the bank account.


 
 Example:  "BOA"
name
string
Name of the bank account.


 
 Example:  "Bank of America"
currency
string
Currency of the bank account.


 
 Example:  "USD"
referenceNumber
string or null
Reference number for the bank fee transaction, such as the transaction number for the interest or service charge from a bank statement.


 
 Example:  "Bank Charges - 01568"
description
string or null
Description of the bank fee transaction.


 
 Example:  "Fee for Bank Charges - 01568"
isInclusiveTax
boolean
 Default:  false
Indicates whether the bank fee transaction is inclusive of tax. Only applies if the txnType is for a service charge. (Taxes subscription)


 
 Example:  true
object
Currency details for the bank fee transaction.


 
txnCurrency
required
string
For multi-currency companies, the currency in which the transaction was incurred.


 
 Example:  "USD"
baseCurrency
string
Base currency for the entity or company.


 
 Example:  "USD"
object
Exchange rate used to calculate the base amount for this transaction. Required if txnCurrency differs from baseCurrency.


 
date
string <date> 
Date of the exchange rate used to calculate the base amount from the transaction amount.


 
 Example:  "2021-01-23"
rate
number
Exchange rate used to calculate the base amount from the transaction amount.


 
 Example:  1.0789
typeId
string
Exchange rate type used to calculate the base amount from the transaction amount.


 
 Example:  "Intacct Daily Rate"
object
Tax solution used to calculate and capture taxes on this transaction. (Taxes subscription)


 
key
string
Unique key for the tax solution.


 
 Example:  "4"
id
string
Identifier for the tax solution.


 
 Example:  "Australia GST"
object
Supporting document attached to this bank fee transaction.


 
key
string
Unique key for the attachment.


 
 Example:  "18"
id
string
Identifier for the attachment.


 
 Example:  "18"
Array of objects
Line items for the bank fee transaction.


 
 Array 
txnAmount
required
string <decimal-precision-2> 
For multi-currency companies, the amount of the line item in the transaction currency.


 
 Example:  "100.99"
totalTxnAmount
string <decimal-precision-2> 
For multi-currency companies, amount of the bank fee line item, including tax. (Taxes subscription)


 
 Example:  "100.99"
description
string or null
Additional information about the bank fee line item.


 
 Example:  "Service charge added for cashing a check."
object
Currency details for the bank fee line item.


 
object
Base location for the line item in a multi-entity company.


 
object
Label for the Accounts Payable (AP) account associated with the service charge on the line item.


 
object
 
object
Bank fee containing the bank fee line item.


 
status
string
 Default:  "active"
Object status. Active objects are fully functional. Inactive objects are essentially hidden and cannot be used or referenced.


 Enum: "active" "inactive"  
 Example:  "active"
Array of objects
Tax entries for the bank fee line item. (Taxes subscription)


 
Responses 
201
Created


400
Bad Request


Request samples 
application/json
{
  • "txnDate": "2024-01-20",
  • "referenceNumber": "10920920",
  • "description": "Check cashing fee for check 0020",
  • "isInclusiveTax": true,
  • "currency": {
    • "txnCurrency": "CAD",
    • "baseCurrency": "USD",
    • "exchangeRate": {
      • "date": "2021-01-20",
      • "typeId": "Intacct Daily Rate",
      • "rate": 0.7306
      }
    },
  • "bankAccount": {
    • "id": "BOA"
    },
  • "taxSolution": {
    • "key": "7",
    • "id": "United Kingdom - VAT"
    },
  • "attachment": {
    • "id": "18"
    },
  • "txnType": "serviceCharge",
  • "lines": [
    • {
      • "totalTxnAmount": "100.00",
      • "txnAmount": "100.00",
      • "description": "Service charge",
      • "glAccount": {
        },
      • "dimensions": {
        },
      • "taxEntries": [
        ]
      }
    ]
}
Response samples 
application/json
{
  • "ia::result": {
    • "key": "500",
    • "id": "500",
    • "href": "/objects/cash-management/bank-fee/500"
    },
  • "ia::meta": {
    • "totalCount": 1,
    • "totalSuccess": 1,
    • "totalError": 0
    }
}
Get a bank fee
get/objects/cash-management/bank-fee/{key}
Returns detailed information for a specified bank fee.


SecurityOAuth2 
Request 
path Parameters
key
required
string
System-assigned unique key for the bank fee.


 
 Example:  134
Responses 
200
OK


400
Bad Request


Request samples 
Response samples 
application/json
{
  • "ia::result": {
    • "id": "547",
    • "key": "547",
    • "bankAccount": {
      • "id": "BOA",
      • "currency": "USD"
      },
    • "txnDate": "2024-01-20",
    • "referenceNumber": "10920920",
    • "txnType": "serviceCharge",
    • "description": "Check cashing fee for check 0020",
    • "currency": {
      • "baseCurrency": "USD",
      • "txnCurrency": "CAD",
      • "exchangeRate": {
        }
      },
    • "totalEntered": "73.06",
    • "txnTotalEntered": "100.00",
    • "state": null,
    • "reconciliationState": "uncleared",
    • "reversedBy": {
      • "id": null,
      • "key": null,
      • "reversalDate": null
      },
    • "reversalOf": {
      • "id": null,
      • "key": null,
      • "txnDate": null
      },
    • "audit": {
      • "createdDateTime": "2025-04-11T12:56:46Z",
      • "modifiedDateTime": "2025-04-11T12:56:46Z",
      • "createdByUser": {
        },
      • "createdBy": "159",
      • "modifiedByUser": {
        },
      • "modifiedBy": "159"
      },
    • "isInclusiveTax": true,
    • "taxSolution": {
      • "key": "7",
      • "id": "United Kingdom - VAT",
      • "href": "/objects/tax/tax-solution/7"
      },
    • "attachment": {
      • "id": "111",
      • "key": "2",
      • "href": "/objects/company-config/attachment/2"
      },
    • "lines": [
      • {
        }
      ],
    • "href": "/objects/cash-management/bank-fee/547"
    },
  • "ia::meta": {
    • "totalCount": 1,
    • "totalSuccess": 1,
    • "totalError": 0
    }
}
Update a bank fee
patch/objects/cash-management/bank-fee/{key}
Updates an existing bank fee transaction by setting field values. Any fields not provided remain unchanged.


SecurityOAuth2 
Request 
path Parameters
key
required
string
System-assigned unique key for the bank fee.


 
 Example:  134
Request Body schema: application/json
referenceNumber
string or null
Reference number for the bank fee transaction, such as the transaction number for the interest or service charge from a bank statement.


 
 Example:  "Bank Charges - 01568"
txnDate
string <date> 
Date when the bank fee transaction occurred.


 
 Example:  "2024-01-23"
description
string or null
Description of the bank fee transaction.


 
 Example:  "Fee for Bank Charges - 01568"
isInclusiveTax
boolean
 Default:  false
Indicates whether the bank fee transaction is inclusive of tax. Only applies if the txnType is for a service charge. (Taxes subscription)


 
 Example:  true
txnType
string
Indicates whether this bank fee transaction is interest earned or a service charge.


 Enum: "interestEarned" "serviceCharge"  
 Example:  "serviceCharge"
object
Bank account in which to record the service charge or interest earned.


 
key
string
Unique key for the bank account.


 
 Example:  "1"
id
string
Identifier for the bank account.


 
 Example:  "BOA"
name
string
Name of the bank account.


 
 Example:  "Bank of America"
currency
string
Currency of the bank account.


 
 Example:  "USD"
object
Currency details for the bank fee transaction.


 
baseCurrency
string
Base currency for the entity or company.


 
 Example:  "USD"
txnCurrency
string
For multi-currency companies, the currency in which the transaction was incurred.


 
 Example:  "USD"
object
Exchange rate used to calculate the base amount for this transaction. Required if txnCurrency differs from baseCurrency.


 
date
string <date> 
Date of the exchange rate used to calculate the base amount from the transaction amount.


 
 Example:  "2021-01-23"
rate
number
Exchange rate used to calculate the base amount from the transaction amount.


 
 Example:  1.0789
typeId
string
Exchange rate type used to calculate the base amount from the transaction amount.


 
 Example:  "Intacct Daily Rate"
object
Tax solution used to calculate and capture taxes on this transaction. (Taxes subscription)


 
key
string
Unique key for the tax solution.


 
 Example:  "4"
id
string
Identifier for the tax solution.


 
 Example:  "Australia GST"
object
Supporting document attached to this bank fee transaction.


 
key
string
Unique key for the attachment.


 
 Example:  "18"
id
string
Identifier for the attachment.


 
 Example:  "18"
Array of objects
Line items for the bank fee transaction.


 
 Array 
totalTxnAmount
string <decimal-precision-2> 
For multi-currency companies, amount of the bank fee line item, including tax. (Taxes subscription)


 
 Example:  "100.99"
txnAmount
string <decimal-precision-2> 
For multi-currency companies, the amount of the line item in the transaction currency.


 
 Example:  "100.99"
description
string or null
Additional information about the bank fee line item.


 
 Example:  "Service charge added for cashing a check."
object
Currency details for the bank fee line item.


 
object
Base location for the line item in a multi-entity company.


 
object
Label for the Accounts Payable (AP) account associated with the service charge on the line item.


 
object
 
object
Bank fee containing the bank fee line item.


 
status
string
 Default:  "active"
Object status. Active objects are fully functional. Inactive objects are essentially hidden and cannot be used or referenced.


 Enum: "active" "inactive"  
 Example:  "active"
Array of objects
Tax entries for the bank fee line item. (Taxes subscription)


 
Responses 
200
OK


400
Bad Request


Request samples 
application/json
{
  • "description": "Bank fee for the check cashing for check number 2002",
  • "lines": [
    • {
      • "key": "88",
      • "bankFee": {
        },
      • "txnAmount": "80.00",
      • "description": "Bank fee update check 2002",
      • "status": "active",
      • "totalTxnAmount": "100.00",
      • "taxEntries": [
        ]
      }
    ]
}
Response samples 
application/json
{
  • "ia::result": {
    • "id": "547",
    • "key": "547",
    • "href": "/objects/cash-management/bank-fee/547"
    },
  • "ia::meta": {
    • "totalCount": 1,
    • "totalSuccess": 1,
    • "totalError": 0
    }
}