Accounts
Subledgers
4 min
cross river cos offers the apis to create subledgers instantly and on demand a subledger can be linked to any existing deposit account, also known as the master account manage subledgers with cross river's apis get api credentials with cross river apis in subledger api endpoints, subledgers are referred to as subaccounts , for example, post /core/v1/dda/subaccounts creates a new subledger once you have access to our sandbox environments you can access these api endpoints in the core module, dda section, through swagger links this table presents the subledger management apis we describe in detail action api call description subledgers /#create a subledger post /core/v1/dda/subaccounts creates a new subledger subledgers /#get information on a specific subledger get /core/v1/dda/subaccounts/{accountnumber} returns information on a specific subledger account create a subledger creates a subledger for the specified master account name create a subledger method post url core v1 dda subaccounts description tab examples examples languages id p9idftsftskm5gwlrp3lq language curl code curl request post n url https sandbox crbcos com core v1 dda subaccounts n header accept application json n header content type application json customlabel selectedlanguageid p9idftsftskm5gwlrp3lq results languages id vjutubmvyylolejt5wkle language 200 customlabel code n accountnumber string n accounttype generalledger n status closed n ledgertype passthrough n title string n currentbalance 0 n availablebalance 0 n holdamount 0 n transactioncount 0 n openedat 2019 01 23t17 20 44 615z n closedat 2019 01 23t17 20 44 615z n masteraccountnumber string n beneficiary n referenceid string n firstname string n middlename string n lastname string n entityname string n streetaddress1 string n streetaddress2 string n city string n state string n postalcode string n countrycode string n phonenumber string n emailaddress string n notes string n n partnerid 196295ef 42c7 4de1 bf60 7a5570b12406 n lastmaintenanceat 2019 01 23t17 20 44 615z n lasttransactedat 2019 01 23t17 20 44 615z n productid 2010ff28 91cb 4b80 9618 bf018502faf2 n lastmodifiedat 2019 01 23t17 20 44 615z n selectedlanguageid vjutubmvyylolejt5wkle request pathparameters queryparameters headerparameters bodydataparameters name masteraccountnumber kind required type string description master account to open the subledger under name title kind required type string description the account title n255 character limit children name customerid kind optional type string description the unique id assigned to a customer when the customer record is created post core v1 cm customers you need this id to take action for a specific customer for example when opening an account or adding an address to a customer record n nthe id is in guid format children name beneficiary kind optional type object description beneficiary profile for this subledger children name referenceid kind optional type string description reference for beneficiary n50 character limit name firstname kind optional type string description the first name of the beneficiary n50 character limit name lastname kind optional type string description the last name of the beneficiary n50 character limit name middlename kind optional type string description the middle name of the beneficiary name entityname kind optional type string description if the beneficiary is a business or organization enter its name if the beneficiary is an individual enter their full name n255 character limit name streetaddress1 kind optional type string description primary location details of account holder for instance street name house building number po box name streetaddress2 kind optional type string description additional address information name city kind optional type string description city full name name state kind optional type string description state name we recommend you enter the 2 character state code name postalcode kind optional type string description postal code also known as zip code name countrcode kind optional type string description 2 letter iso country code name phonenumber kind optional type string description the beneficiary phone number name emailaddress kind optional type string description 255 character limit name notes kind optional type string description general notes about the beneficiary name clientidentifier kind optional type string description use this attribute to add your own unique identifying string to a payment call or cos record this attribute is useful for idempotency purposes children formdataparameters currentnewparameter label body parameter value bodydataparameters response name accountnumber kind optional type string description the subledger account number name accounttype kind optional type string description deposit account type checkingsavingsgeneralledgerloan children name status kind optional type string description account status n n inactive n active n dormant n escheat n closed n chargeoff children name ledgertype kind optional type string description ledger type passthroughdirect children name title kind optional type string description the name on the account usually this is the account holder name but not always children name currentbalance kind optional type integer description current balance a negative amount means a debit and a positive amount means a credit children name availablebalance kind optional type integer description available amount of the balance a negative amount means a debit and a positive amount means a credit children name holdamount kind optional type integer description amount of the hold if any placed on the account children name transactioncount kind optional type integer description total number of transactions posted to the account children name openedat kind optional type string description date and time the deposit account was opened the date and time are in this format yyyy mm ddthh mm ss mmm children name closedat kind optional type string description the date and time that the account was closed children name masteraccountnumber kind optional type string description master account the subledger was opened under children name beneficiary kind optional type object description beneficiary profile for this subledger children name referenceid kind optional type string description reference for beneficiary n50 character limit name firstname kind optional type string description the first name of the beneficiary n50 character limit name lastname kind optional type string description the last name of the beneficiary n50 character limit name middlename kind optional type string description the middle name of the beneficiary name entityname kind optional type string description if the beneficiary is a business or organization enter its name if the beneficiary is an individual enter their full name n255 character limit name streeetaddress1 kind optional type string description primary location details of account holder for instance street name house building number po box name streeetaddress2 kind optional type string description additional address information name city kind optional type string description city full name name state kind optional type string description state name we recommend you enter the 2 character state code name postalcode kind optional type string description postal code also known as zip code name countrycode kind optional type string description 2 letter iso country code name phonenumber kind optional type string description the beneficiary phone number name emailaddress kind optional type string description 255 character limit name notes kind optional type string description general notes about the beneficiary name notes kind optional type string description general notes about the beneficiary children name partnerid kind optional type string description cos id of the partner associated with the account children name lastmaintenancedat kind optional type string description date and time the account was last modified children name lasttransactedat kind optional type string description the date and time a transaction last took place on the account children name productid kind optional type string description the cos id of the product associated with the account children get information on a specific subledger returns information on a specific subledger account name get information on a specific subledger method get url core v1 dda subaccounts accountnumber description tab examples examples languages id csk74uz1d9pf5ce3jduzf language curl code curl request get n url https sandbox crbcos com core v1 dda subaccounts n header accept application json customlabel selectedlanguageid csk74uz1d9pf5ce3jduzf results languages id wk6fz9yqqet2djskuk3xj language 200 customlabel code n accountnumber string n accounttype generalledger n status closed n ledgertype passthrough n title string n currentbalance 0 n availablebalance 0 n holdamount 0 n transactioncount 0 n openedat 2019 01 23t17 20 44 615z n closedat 2019 01 23t17 20 44 615z n masteraccountnumber string n beneficiary n referenceid string n firstname string n middlename string n lastname string n entityname string n streetaddress1 string n streetaddress2 string n city string n state string n postalcode string n countrycode string n phonenumber string n emailaddress string n notes string n n partnerid 00000000 0000 0000 0000 000000000000 n lastmaintenanceat 2019 01 23t17 20 44 615z n lasttransactedat 2019 01 23t17 20 44 615z n productid 00000000 0000 0000 0000 000000000000 n lastmodifiedat 2019 01 23t17 20 44 615z n selectedlanguageid wk6fz9yqqet2djskuk3xj request pathparameters name accountnumber kind required type string description sub account number to retrieve children queryparameters headerparameters bodydataparameters formdataparameters currentnewparameter label path parameter value pathparameters response name accountnumber kind optional type string description the subledger account number name accounttype kind optional type string description deposit account type checkingsavingsgeneralledgerloan children name status kind optional type string description account status inactiveactivedormantescheatclosedchargeoff children name ledgertype kind optional type string description ledger type passthroughdirect children name title kind optional type string description the name on the account usually this is the account holder name but not always children name currentbalance kind optional type integer description the account s current balance children name availablebalance kind optional type integer description current balance a negative amount means a debit and a positive amount means a credit children name holdamount kind optional type integer description amount of the hold if any placed on the deposit account children name transactioncount kind optional type integer description total number of transactions posted to the account children name openedat kind optional type string description date and time the deposit account was opened the date and time are in this format yyyy mm ddthh mm ss mmm children name closedat kind optional type string description the date and time that the account was closed children name masteraccountnumber kind optional type string description master account the subledger was opened under children name beneficiary kind optional type object description beneficiary profile for this subledger children name referenceid kind optional type string description reference for beneficiary n50 character limit name firstname kind optional type string description the first name of the beneficiary n50 character limit name lastname kind optional type string description the last name of the beneficiary n50 character limit name middlename kind optional type string description the middle name of the beneficiary name entityname kind optional type string description if the beneficiary is a business or organization enter its name if the beneficiary is an individual enter their full name n255 character limit name streetaddress1 kind optional type string description primary location details of account holder for instance street name house building number po box name streetaddress2 kind optional type string description additional address information name city kind optional type string description city full name name state kind optional type string description state name we recommend you enter the 2 character state code name postalcode kind optional type string description postal code also known as zip code name countrycode kind optional type string description 2 letter iso country code name phonenumber kind optional type string description the beneficiary phone number name emailaddress kind optional type string description 255 character limit name notes kind optional type string description general notes about the beneficiary name partnerid kind optional type string description cos id of the partner associated with the account children name lastmaintenancedat kind optional type string description date and time the deposit account last had maintenance performed on it the date and time are in this format yyyy mm ddthh mm ss mmm children name lasttransactedat kind optional type string description the date and time a transaction last took place on the deposit account the date and time are in this format yyyy mm ddthh mm ss mmm children name productid kind optional type string description id in guid format of your specific product type on which the account is based provided by cr children