Bank Feed Accounts
The
BankFeedAccount object represents a bank feed account, detailing various attributes including account identifiers, names, currency, and balance information. This object is central to managing and tracking bank feed accounts within the system.Properties
idUUIDremote_idStringThe third-party API ID of the matching object.
created_atDateTime (ISO 8601)The datetime that this object was created by Merge.
modified_atDateTime (ISO 8601)The datetime that this object was modified by Merge.
source_account_idStringThe unique identifier of the source account from our customer’s platform.
target_account_idStringThe unique identifier of the target account from the third party software.
source_account_nameStringThe name of the source account as stored in our customer’s platform.
source_account_numberStringThe human-readable account number of the source account as stored in our customer’s platform.
target_account_nameStringThe name of the target account from the third party software.
currencyEnumThe currency code of the bank feed. Possible values include:
XUA, AFN, AFA, ALL, ALK, DZD, ADP, AOA, AOK, AON, AOR, ARA, ARS, ARM, ARP, ARL, AMD, AWG, AUD, ATS, AZN, AZM, BSD, BHD, BDT, BBD, BYN, BYB, BYR, BEF, BEC, BEL, BZD, BMD, BTN, BOB, BOL, BOV, BOP, BAM, BAD, BAN, BWP, BRC, BRZ, BRE, BRR, BRN, BRB, BRL, GBP, BND, BGL, BGN, BGO, BGM, BUK, BIF, XPF, KHR, CAD, CVE, KYD, XAF, CLE, CLP, CLF, CNX, CNY, CNH, COP, COU, KMF, CDF, CRC, HRD, HRK, CUC, CUP, CYP, CZK, CSK, DKK, DJF, DOP, NLG, XCD, DDM, ECS, ECV, EGP, GQE, ERN, EEK, ETB, EUR, XBA, XEU, XBB, XBC, XBD, FKP, FJD, FIM, FRF, XFO, XFU, GMD, GEK, GEL, DEM, GHS, GHC, GIP, XAU, GRD, GTQ, GWP, GNF, GNS, GYD, HTG, HNL, HKD, HUF, IMP, ISK, ISJ, INR, IDR, IRR, IQD, IEP, ILS, ILP, ILR, ITL, JMD, JPY, JOD, KZT, KES, KWD, KGS, LAK, LVL, LVR, LBP, LSL, LRD, LYD, LTL, LTT, LUL, LUC, LUF, MOP, MKD, MKN, MGA, MGF, MWK, MYR, MVR, MVP, MLF, MTL, MTP, MRU, MRO, MUR, MXV, MXN, MXP, MDC, MDL, MCF, MNT, MAD, MAF, MZE, MZN, MZM, MMK, NAD, NPR, ANG, TWD, NZD, NIO, NIC, NGN, KPW, NOK, OMR, PKR, XPD, PAB, PGK, PYG, PEI, PEN, PES, PHP, XPT, PLN, PLZ, PTE, GWE, QAR, XRE, RHD, RON, ROL, RUB, RUR, RWF, SVC, WST, SAR, RSD, CSD, SCR, SLL, XAG, SGD, SKK, SIT, SBD, SOS, ZAR, ZAL, KRH, KRW, KRO, SSP, SUR, ESP, ESA, ESB, XDR, LKR, SHP, XSU, SDD, SDG, SDP, SRD, SRG, SZL, SEK, CHF, SYP, STN, STD, TVD, TJR, TJS, TZS, XTS, THB, XXX, TPE, TOP, TTD, TND, TRY, TRL, TMT, TMM, USD, USN, USS, UGX, UGS, UAH, UAK, AED, UYW, UYU, UYP, UYI, UZS, VUV, VES, VEB, VEF, VND, VNN, CHE, CHW, XOF, YDD, YER, YUN, YUD, YUM, YUR, ZWN, ZRN, ZRZ, ZMW, ZMK, ZWD, ZWR, ZWL. In cases where there is no clear mapping, the original value passed through will be returned. To receive all enum values in the original format, use the show_enum_origins query parameter. Learn more.feed_statusEnumThe status of the bank feed. Possible values include:
ACTIVE, INACTIVE. In cases where there is no clear mapping, the original value passed through will be returned. To receive all enum values in the original format, use the show_enum_origins query parameter. Learn more.feed_start_dateDateTime (ISO 8601)The start date of the bank feed’s transactions.
source_account_balanceNumberThe current balance of funds in the source account.
account_typeEnumThe type of the account. Possible values include:
BANK, CREDIT_CARD. In cases where there is no clear mapping, the original value passed through will be returned. To receive all enum values in the original format, use the show_enum_origins query parameter. Learn more.remote_was_deletedBooleanIndicates whether or not this object has been deleted in the third party platform. Full coverage deletion detection is a premium add-on. Native deletion detection is offered for free with limited coverage. Learn more.
field_mappingsObjectremote_dataRemoteData[]The RemoteData object
The
RemoteData object is used to represent the full data pulled from the third-party API for an object.Properties
pathStringThe third-party API path that is being called.
dataAnyThe data returned from the third-party for this object in its original, unnormalized format.
GET
/bank-feed-accounts
Betahttps://api.merge.dev/api/accounting/v1/bank-feed-accounts
US
EU
APAC
Returns a list of BankFeedAccount objects.
Query & path parameters
cursorStringOptional
The pagination cursor value.
include_deleted_dataBooleanOptional
Indicates whether or not this object has been deleted in the third party platform. Full coverage deletion detection is a premium add-on. Native deletion detection is offered for free with limited coverage. Learn more.
include_remote_dataBooleanOptional
Whether to include the original data Merge fetched from the third-party to produce these models.
include_shell_dataBooleanOptional
Whether to include shell records. Shell records are empty records (they may contain some metadata but all other fields are null).
page_sizeIntegerOptional
Number of results to return per page. The maximum limit is 100.
Field support by integration
Use the /linked-accounts endpoint to pull platform support information

Xero
On top of normalized Common Models, Merge also supports Passthrough Requests and deleted data detection for this platform's API
Supported Response Fields
account_typeEnumcurrencyEnumfeed_statusEnumremote_dataRemoteData[]pathstringdatastringremote_idStringsource_account_idStringtarget_account_idStringtarget_account_nameStringNot seeing an integration that you're looking for?
POST
/bank-feed-accounts
Betahttps://api.merge.dev/api/accounting/v1/bank-feed-accounts
US
EU
APAC
Creates a BankFeedAccount object with the given values. To run asynchronously, see our guide.
Query & path parameters
is_debug_modeBooleanOptional
Whether to include debug fields (such as log file links) in the response.
run_asyncBooleanOptional
Whether or not third-party updates should be run asynchronously.
Body parameters
modelObjectRequired
Find available fields below under “Model Parameters”.
Model parameters
View app-specific writable fields under “Field support by platform” in this section.source_account_idStringThe unique identifier of the source account from our customer’s platform.
target_account_idStringThe unique identifier of the target account from the third party software.
source_account_nameStringThe name of the source account as stored in our customer’s platform.
source_account_numberStringThe human-readable account number of the source account as stored in our customer’s platform.
target_account_nameStringThe name of the target account from the third party software.
currencyEnumThe currency code of the bank feed. Must pass in one of the following choices:
XUA, AFN, AFA, ALL, ALK, DZD, ADP, AOA, AOK, AON, AOR, ARA, ARS, ARM, ARP, ARL, AMD, AWG, AUD, ATS, AZN, AZM, BSD, BHD, BDT, BBD, BYN, BYB, BYR, BEF, BEC, BEL, BZD, BMD, BTN, BOB, BOL, BOV, BOP, BAM, BAD, BAN, BWP, BRC, BRZ, BRE, BRR, BRN, BRB, BRL, GBP, BND, BGL, BGN, BGO, BGM, BUK, BIF, XPF, KHR, CAD, CVE, KYD, XAF, CLE, CLP, CLF, CNX, CNY, CNH, COP, COU, KMF, CDF, CRC, HRD, HRK, CUC, CUP, CYP, CZK, CSK, DKK, DJF, DOP, NLG, XCD, DDM, ECS, ECV, EGP, GQE, ERN, EEK, ETB, EUR, XBA, XEU, XBB, XBC, XBD, FKP, FJD, FIM, FRF, XFO, XFU, GMD, GEK, GEL, DEM, GHS, GHC, GIP, XAU, GRD, GTQ, GWP, GNF, GNS, GYD, HTG, HNL, HKD, HUF, IMP, ISK, ISJ, INR, IDR, IRR, IQD, IEP, ILS, ILP, ILR, ITL, JMD, JPY, JOD, KZT, KES, KWD, KGS, LAK, LVL, LVR, LBP, LSL, LRD, LYD, LTL, LTT, LUL, LUC, LUF, MOP, MKD, MKN, MGA, MGF, MWK, MYR, MVR, MVP, MLF, MTL, MTP, MRU, MRO, MUR, MXV, MXN, MXP, MDC, MDL, MCF, MNT, MAD, MAF, MZE, MZN, MZM, MMK, NAD, NPR, ANG, TWD, NZD, NIO, NIC, NGN, KPW, NOK, OMR, PKR, XPD, PAB, PGK, PYG, PEI, PEN, PES, PHP, XPT, PLN, PLZ, PTE, GWE, QAR, XRE, RHD, RON, ROL, RUB, RUR, RWF, SVC, WST, SAR, RSD, CSD, SCR, SLL, XAG, SGD, SKK, SIT, SBD, SOS, ZAR, ZAL, KRH, KRW, KRO, SSP, SUR, ESP, ESA, ESB, XDR, LKR, SHP, XSU, SDD, SDG, SDP, SRD, SRG, SZL, SEK, CHF, SYP, STN, STD, TVD, TJR, TJS, TZS, XTS, THB, XXX, TPE, TOP, TTD, TND, TRY, TRL, TMT, TMM, USD, USN, USS, UGX, UGS, UAH, UAK, AED, UYW, UYU, UYP, UYI, UZS, VUV, VES, VEB, VEF, VND, VNN, CHE, CHW, XOF, YDD, YER, YUN, YUD, YUM, YUR, ZWN, ZRN, ZRZ, ZMW, ZMK, ZWD, ZWR, ZWL.feed_statusEnumThe status of the bank feed. Must pass in one of the following choices:
ACTIVE, INACTIVE.feed_start_dateDateTime (ISO 8601)The start date of the bank feed’s transactions.
source_account_balanceNumberThe current balance of funds in the source account.
account_typeEnumThe type of the account. Must pass in one of the following choices:
BANK, CREDIT_CARD.integration_paramsObjectlinked_account_paramsObjectField support by integration
Use the /linked-accounts endpoint to pull platform support information

NetSuite
On top of normalized Common Models, Merge also supports Passthrough Requests for this platform's API
Supported POST Model Parameters
account_typeEnumRequired
currencyEnumOptional
feed_start_dateDateTime (ISO 8601)Optional
feed_statusEnumOptional
source_account_balanceNumberOptional
source_account_idStringRequired
source_account_nameStringRequired
source_account_numberStringOptional
target_account_idStringRequired
target_account_nameStringOptional

Xero
On top of normalized Common Models, Merge also supports Passthrough Requests for this platform's API
Supported POST Model Parameters
account_typeEnumRequired
currencyEnumRequired
feed_start_dateDateTime (ISO 8601)Optional
feed_statusEnumOptional
remote_idStringOptional
source_account_balanceNumberOptional
source_account_idStringRequired
source_account_nameStringOptional
source_account_numberStringOptional
target_account_idStringRequired
target_account_nameStringRequired
Additional POST Parameters
integration_paramsObjectRequired
account_tokenStringRequired
target_account_numberStringRequired
Not seeing an integration that you're looking for?
To include the correct model fields when making POST requests, use the GET /bank-feed-accounts/meta/post endpoint. Learn more in our /meta guide.
GET
/bank-feed-accounts/{id}
Betahttps://api.merge.dev/api/accounting/v1/bank-feed-accounts/{id}
US
EU
APAC
Returns a BankFeedAccount object with the given id.
Query & path parameters
idUUIDRequired
include_remote_dataBooleanOptional
Whether to include the original data Merge fetched from the third-party to produce these models.
include_shell_dataBooleanOptional
Whether to include shell records. Shell records are empty records (they may contain some metadata but all other fields are null).
Field support by integration
Use the /linked-accounts endpoint to pull platform support information

Xero
On top of normalized Common Models, Merge also supports Passthrough Requests and deleted data detection for this platform's API
Supported Response Fields
account_typeEnumcurrencyEnumfeed_statusEnumremote_dataRemoteData[]pathstringdatastringremote_idStringsource_account_idStringtarget_account_idStringtarget_account_nameStringNot seeing an integration that you're looking for?
GET
/bank-feed-accounts/meta/post
Betahttps://api.merge.dev/api/accounting/v1/bank-feed-accounts/meta/post
US
EU
APAC
Returns metadata for BankFeedAccount POSTs.
Field support by integration
Use the /linked-accounts endpoint to pull platform support information

NetSuite
On top of normalized Common Models, Merge also supports Passthrough Requests for this platform's API
Supported POST Model Parameters
account_typeEnumRequired
currencyEnumOptional
feed_start_dateDateTime (ISO 8601)Optional
feed_statusEnumOptional
source_account_balanceNumberOptional
source_account_idStringRequired
source_account_nameStringRequired
source_account_numberStringOptional
target_account_idStringRequired
target_account_nameStringOptional

Xero
On top of normalized Common Models, Merge also supports Passthrough Requests for this platform's API
Supported POST Model Parameters
account_typeEnumRequired
currencyEnumRequired
feed_start_dateDateTime (ISO 8601)Optional
feed_statusEnumOptional
remote_idStringOptional
source_account_balanceNumberOptional
source_account_idStringRequired
source_account_nameStringOptional
source_account_numberStringOptional
target_account_idStringRequired
target_account_nameStringRequired
Additional POST Parameters
integration_paramsObjectRequired
account_tokenStringRequired
target_account_numberStringRequired
Not seeing an integration that you're looking for?