Accounts
Subledgers APIs
Create subledger
1 min
{ "name" "endpoint /core/v1/dda/subaccounts", "method" "post", "url" " https //sandbox crbcos com/core/v1/dda/subaccounts", "description" "creates a subledger for the specified master account ", "tab" "examples", "examples" { "languages" \[ { "id" "p9idftsftskm5gwlrp3lq", "language" "curl", "code" "curl location 'https //sandbox crbcos com/core/v1/dda/subaccounts' \\\\\n header 'idempotency key 3392de17 6e92 4999 b943 cad5f19b1629' \\\\\n data '{\n \\"masteraccountnumber\\" \\"2819503463\\",\n \\"title\\" \\"jerry penn\\",\n \\"customerid\\" \\"53c34cf0 4cd2 4768 937b b30000dffdca\\",\n \\"beneficiary\\" {\n \\"firstname\\" \\"jerry\\" ,\n \\"lastname\\" \\"penn\\",\n \\"streetaddress1\\" \\"12 main st\\",\n \\"city\\" \\"new york\\",\n \\"state\\" \\"ny\\",\n \\"postalcode\\" \\"10001\\",\n \\"countrycode\\" \\"us\\"\n }\n}\n\n'", "customlabel" "" }, { "id" "7l7yai28rhh qfcfgclp4", "language" "nodejs", "code" "var https = require('follow redirects') https;\nvar fs = require('fs');\n\nvar options = {\n 'method' 'post',\n 'hostname' 'sandbox crbcos com',\n 'path' '/core/v1/dda/subaccounts',\n 'headers' {\n 'idempotency key' '3392de17 6e92 4999 b943 cad5f19b1629'\n },\n 'maxredirects' 20\n};\n\nvar req = https request(options, function (res) {\n var chunks = \[];\n\n res on(\\"data\\", function (chunk) {\n chunks push(chunk);\n });\n\n res on(\\"end\\", function (chunk) {\n var body = buffer concat(chunks);\n console log(body tostring());\n });\n\n res on(\\"error\\", function (error) {\n console error(error);\n });\n});\n\nvar postdata = \\"{\\\r\\\n \\\\\\"masteraccountnumber\\\\\\" \\\\\\"2819503463\\\\\\",\\\r\\\n \\\\\\"title\\\\\\" \\\\\\"jerry penn\\\\\\",\\\r\\\n \\\\\\"customerid\\\\\\" \\\\\\"53c34cf0 4cd2 4768 937b b30000dffdca\\\\\\",\\\r\\\n \\\\\\"beneficiary\\\\\\" {\\\r\\\n \\\\\\"firstname\\\\\\" \\\\\\"jerry\\\\\\" ,\\\r\\\n \\\\\\"lastname\\\\\\" \\\\\\"penn\\\\\\",\\\r\\\n \\\\\\"streetaddress1\\\\\\" \\\\\\"12 main st\\\\\\",\\\r\\\n \\\\\\"city\\\\\\" \\\\\\"new york\\\\\\",\\\r\\\n \\\\\\"state\\\\\\" \\\\\\"ny\\\\\\",\\\r\\\n \\\\\\"postalcode\\\\\\" \\\\\\"10001\\\\\\",\\\r\\\n \\\\\\"countrycode\\\\\\" \\\\\\"us\\\\\\"\\\r\\\n }\\\r\\\n}\\\r\\\n\\\r\\\n\\";\n\nreq write(postdata);\n\nreq end();", "customlabel" "" }, { "id" "ynduk387y n1nrdjizm8u", "language" "python", "code" "import http client\n\nconn = http client httpsconnection(\\"sandbox crbcos com\\")\npayload = \\"{\\\r\\\n \\\\\\"masteraccountnumber\\\\\\" \\\\\\"2819503463\\\\\\",\\\r\\\n \\\\\\"title\\\\\\" \\\\\\"jerry penn\\\\\\",\\\r\\\n \\\\\\"customerid\\\\\\" \\\\\\"53c34cf0 4cd2 4768 937b b30000dffdca\\\\\\",\\\r\\\n \\\\\\"beneficiary\\\\\\" {\\\r\\\n \\\\\\"firstname\\\\\\" \\\\\\"jerry\\\\\\" ,\\\r\\\n \\\\\\"lastname\\\\\\" \\\\\\"penn\\\\\\",\\\r\\\n \\\\\\"streetaddress1\\\\\\" \\\\\\"12 main st\\\\\\",\\\r\\\n \\\\\\"city\\\\\\" \\\\\\"new york\\\\\\",\\\r\\\n \\\\\\"state\\\\\\" \\\\\\"ny\\\\\\",\\\r\\\n \\\\\\"postalcode\\\\\\" \\\\\\"10001\\\\\\",\\\r\\\n \\\\\\"countrycode\\\\\\" \\\\\\"us\\\\\\"\\\r\\\n }\\\r\\\n}\\\r\\\n\\\r\\\n\\"\nheaders = {\n 'idempotency key' '3392de17 6e92 4999 b943 cad5f19b1629'\n}\nconn request(\\"post\\", \\"/core/v1/dda/subaccounts\\", payload, headers)\nres = conn getresponse()\ndata = res read()\nprint(data decode(\\"utf 8\\"))", "customlabel" "" }, { "id" "x xbtfbheywkwytmqg om", "language" "ruby", "code" "require \\"uri\\"\nrequire \\"net/http\"\n\nurl = uri(\\"https //sandbox crbcos com/core/v1/dda/subaccounts\\")\n\nhttps = net http new(url host, url port)\nhttps use ssl = true\n\nrequest = net http post new(url)\nrequest\[\\"idempotency key\\"] = \\"3392de17 6e92 4999 b943 cad5f19b1629\\"\nrequest body = \\"{\\\r\\\n \\\\\\"masteraccountnumber\\\\\\" \\\\\\"2819503463\\\\\\",\\\r\\\n \\\\\\"title\\\\\\" \\\\\\"jerry penn\\\\\\",\\\r\\\n \\\\\\"customerid\\\\\\" \\\\\\"53c34cf0 4cd2 4768 937b b30000dffdca\\\\\\",\\\r\\\n \\\\\\"beneficiary\\\\\\" {\\\r\\\n \\\\\\"firstname\\\\\\" \\\\\\"jerry\\\\\\" ,\\\r\\\n \\\\\\"lastname\\\\\\" \\\\\\"penn\\\\\\",\\\r\\\n \\\\\\"streetaddress1\\\\\\" \\\\\\"12 main st\\\\\\",\\\r\\\n \\\\\\"city\\\\\\" \\\\\\"new york\\\\\\",\\\r\\\n \\\\\\"state\\\\\\" \\\\\\"ny\\\\\\",\\\r\\\n \\\\\\"postalcode\\\\\\" \\\\\\"10001\\\\\\",\\\r\\\n \\\\\\"countrycode\\\\\\" \\\\\\"us\\\\\\"\\\r\\\n }\\\r\\\n}\\\r\\\n\\\r\\\n\\"\n\nresponse = https request(request)\nputs response read body\n", "customlabel" "" }, { "id" "yisgdl1o4h5xd4f1me99y", "language" "go", "code" "package main\n\nimport (\n \\"fmt\\"\n \\"strings\\"\n \\"net/http\"\n \\"io\\"\n)\n\nfunc main() {\n\n url = \\"https //sandbox crbcos com/core/v1/dda/subaccounts\\"\n method = \\"post\\"\n\n payload = strings newreader(`{`+\\"\n\\"+`\n \\"masteraccountnumber\\" \\"2819503463\\",`+\\"\n\\"+`\n \\"title\\" \\"jerry penn\\",`+\\"\n\\"+`\n \\"customerid\\" \\"53c34cf0 4cd2 4768 937b b30000dffdca\\",`+\\"\n\\"+`\n \\"beneficiary\\" {`+\\"\n\\"+`\n \\"firstname\\" \\"jerry\\" ,`+\\"\n\\"+`\n \\"lastname\\" \\"penn\\",`+\\"\n\\"+`\n \\"streetaddress1\\" \\"12 main st\\",`+\\"\n\\"+`\n \\"city\\" \\"new york\\",`+\\"\n\\"+`\n \\"state\\" \\"ny\\",`+\\"\n\\"+`\n \\"postalcode\\" \\"10001\\",`+\\"\n\\"+`\n \\"countrycode\\" \\"us\\"`+\\"\n\\"+`\n }`+\\"\n\\"+`\n}`+\\"\n\\"+`\n`+\\"\n\\"+`\n`)\n\n client = \&http client {\n }\n req, err = http newrequest(method, url, payload)\n\n if err != nil {\n fmt println(err)\n return\n }\n req header add(\\"idempotency key\\", \\"3392de17 6e92 4999 b943 cad5f19b1629\\")\n\n res, err = client do(req)\n if err != nil {\n fmt println(err)\n return\n }\n defer res body close()\n\n body, err = io readall(res body)\n if err != nil {\n fmt println(err)\n return\n }\n fmt println(string(body))\n}", "customlabel" "" } ], "selectedlanguageid" "p9idftsftskm5gwlrp3lq" }, "results" { "languages" \[ { "id" "vjutubmvyylolejt5wkle", "language" "200", "customlabel" "", "code" "{\n \\"accountnumber\\" \\"302022615264\\",\n \\"accounttype\\" \\"deposit\\",\n \\"status\\" \\"active\\",\n \\"ledgertype\\" \\"passthrough\\",\n \\"producttype\\" \\"checking\\",\n \\"title\\" \\"jerry penn\\",\n \\"currentbalance\\" 0,\n \\"availablebalance\\" 0,\n \\"holdamount\\" 0,\n \\"transactioncount\\" 0,\n \\"creditlimit\\" 0,\n \\"currency\\" \\"usd\\",\n \\"openedat\\" \\"2025 06 24t03 05 04 7952946 04 00\\",\n \\"masteraccountnumber\\" \\"2819503463\\",\n \\"customerid\\" \\"53c34cf0 4cd2 4768 937b b30000dffdca\\",\n \\"beneficiary\\" {\n \\"firstname\\" \\"jerry\\",\n \\"lastname\\" \\"penn\\",\n \\"streetaddress1\\" \\"12 main st\\",\n \\"city\\" \\"new york\\",\n \\"state\\" \\"ny\\",\n \\"postalcode\\" \\"10001\\",\n \\"countrycode\\" \\"us\\"\n },\n \\"partnerid\\" \\"cd9c12f4 7691 424a b38b af5b0134c611\\",\n \\"lastmaintenanceat\\" \\"2025 06 24t03 05 04 7952946 04 00\\",\n \\"productid\\" \\"83bed086 8182 4151 a1e3 af5b01362783\\",\n \\"lastmodifiedat\\" \\"2025 06 24t03 05 04 8043224 04 00\\"\n}" }, { "id" "phtrfkpkw8fxnnmnfrarx", "language" "400", "code" "{\n \\"errors\\" \[\n {\n \\"code\\" 2110,\n \\"message\\" \\"beneficiary required\\"\n }\n ]\n}20", "customlabel" "" } ], "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 name on the account usually this is the account holder name, but not always \n255 characters maximum ", "" "the name on the account usually this is the account holder name, but not always \n255 characters maximum " }, { "name" "customerid", "kind" "optional", "type" "string", "description" "the unique id assigned to a customer when the customer record is created 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 ", "" "the unique id assigned to a customer when the customer record is created 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 " }, { "name" "beneficiary", "kind" "optional", "type" "object", "description" "beneficiary profile for this subledger", "children" \[ { "name" "referenceid", "kind" "optional", "type" "string", "description" "reference for beneficiary 50 character limit " }, { "name" "firstname", "kind" "optional", "type" "string", "description" "first name of the beneficiary 50 character limit " }, { "name" "middlename", "kind" "optional", "type" "string", "description" "middle name of the beneficiary 50 character limit " }, { "name" "lastname", "kind" "optional", "type" "string", "description" "last name of the beneficiary 50 character limit " }, { "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 255 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" "beneficiary phone number" }, { "name" "emailaddress", "kind" "optional", "type" "string", "description" "beneficiary email address 255 character limit " }, { "name" "notes", "kind" "optional", "type" "string", "description" "general notes about the beneficiary" }, { "name" "taxidtype", "kind" "optional", "type" "string", "description" "tax id type for the beneficiary \n ssn (social security number)\n ein (employer identification number)\n itin (individual tax id number)\n vat (international vat number)\n foreign (non us domestic)" }, { "name" "taxid", "kind" "optional", "type" "string", "description" "benficiary tax id number" }, { "name" "birthdate", "kind" "optional", "type" "string", "description" "beneficiary birthdate in the format yyyy mm dd" }, { "name" "dateformed", "kind" "optional", "type" "string", "description" "date the subledger was formed, in the format yyyy mm dd" } ], "schema" \[ { "name" "referenceid", "kind" "optional", "type" "string", "description" "reference for beneficiary 50 character limit " }, { "name" "firstname", "kind" "optional", "type" "string", "description" "first name of the beneficiary 50 character limit " }, { "name" "middlename", "kind" "optional", "type" "string", "description" "middle name of the beneficiary 50 character limit " }, { "name" "lastname", "kind" "optional", "type" "string", "description" "last name of the beneficiary 50 character limit " }, { "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 255 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" "beneficiary phone number" }, { "name" "emailaddress", "kind" "optional", "type" "string", "description" "beneficiary email address 255 character limit " }, { "name" "notes", "kind" "optional", "type" "string", "description" "general notes about the beneficiary" }, { "name" "taxidtype", "kind" "optional", "type" "string", "description" "tax id type for the beneficiary \n ssn (social security number)\n ein (employer identification number)\n itin (individual tax id number)\n vat (international vat number)\n foreign (non us domestic)" }, { "name" "taxid", "kind" "optional", "type" "string", "description" "benficiary tax id number" }, { "name" "birthdate", "kind" "optional", "type" "string", "description" "beneficiary birthdate in the format yyyy mm dd" }, { "name" "dateformed", "kind" "optional", "type" "string", "description" "date the subledger was formed, in the format yyyy mm dd" } ] }, { "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 \n generalledger\n deposit\n creditcard\n storedvalue\n wallet\n unknown", "children" \[] }, { "name" "status", "kind" "optional", "type" "string", "description" "subledger account status \n closed\n active", "children" \[] }, { "name" "ledgertype", "kind" "optional", "type" "string", "description" "the subledger type \n passthrough\n direct", "children" \[] }, { "name" "producttype", "kind" "optional", "type" "string", "description" "one of \n generalledger\n checking\n savings\n timedeposit\n moneymarket\n creditcard\n storedvalue\n wallet\n unknown", "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" "creditlimit", "kind" "optional", "type" "integer", "description" "credit limit of the account customer", "children" \[] }, { "name" "currency", "kind" "optional", "type" "string", "description" "currency held in 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 the date and time are in this format yyyy mm ddthh\ mm\ ss\[ mmm] ", "children" \[] }, { "name" "masteraccountnumber", "kind" "optional", "type" "string", "description" "master account the subledger was opened under", "children" \[] }, { "name" "customerid", "kind" "optional", "type" "string", "description" "the unique id assigned to a customer when the customer record is created 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 ", "children" \[] }, { "name" "beneficiary", "kind" "optional", "type" "object", "description" "beneficiary profile for this subledger", "children" \[ { "name" "referenceid", "kind" "optional", "type" "string", "description" "reference for beneficiary" }, { "name" "firstname", "kind" "optional", "type" "string", "description" "the first name of the beneficiary" }, { "name" "middlename", "kind" "optional", "type" "string", "description" "the middle name of the beneficiary" }, { "name" "lastname", "kind" "optional", "type" "string", "description" "the last 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 " }, { "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" }, { "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" "beneficiary phone number" }, { "name" "emailaddress", "kind" "optional", "type" "string", "description" "beneficiary email address" }, { "name" "notes", "kind" "optional", "type" "string", "description" "general notes about the beneficiary" }, { "name" "taxidtype", "kind" "optional", "type" "string", "description" "tax id type for the beneficiary \n ssn (social security number)\n ein (employer identification number)\n itin (individual tax id number)\n vat (international vat number)\n foreign (non us domestic)" }, { "name" "taxid", "kind" "optional", "type" "string", "description" "beneficitary tax id number" }, { "name" "birthdate", "kind" "optional", "type" "string", "description" "beneficiary birthdate" }, { "name" "dateformed", "kind" "optional", "type" "string", "description" "date the subledger was formed" } ] }, { "name" "partnerid", "kind" "optional", "type" "string", "description" "your id in the cross river system", "children" \[] }, { "name" "lastmaintenanceat", "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 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 cross river ", "children" \[] }, { "name" "clientidentifier", "kind" "optional", "type" "string", "description" "your own unique identifying string to a payment call or cos record this attribute is useful for idempotency purposes ", "children" \[] }, { "name" "lastmodifiedat", "kind" "optional", "type" "string", "description" "internal cross river value date and time the database entry was last modified ", "children" \[] }, { "name" "balances", "kind" "optional", "type" "object", "description" "there can be multiple account balances listed", "children" \[ { "name" "accountnumber", "kind" "optional", "type" "string", "description" "number of the account this information describes" }, { "name" "issubaccount", "kind" "optional", "type" "boolean", "description" "if the account balance presented is for a subledger, true otherwise false " }, { "name" "currency", "kind" "optional", "type" "string", "description" "currency held in the account" }, { "name" "currentbalance", "kind" "optional", "type" "integer", "description" "balance including all transactions even if they have not yet settled" }, { "name" "availablebalance", "kind" "optional", "type" "integer", "description" "balance available to the account holder" }, { "name" "holdamount", "kind" "optional", "type" "integer", "description" "amount of funds that cannot yet be accessed because the funds are on hold" }, { "name" "transactioncount", "kind" "optional", "type" "integer", "description" "number of transactions in the last period" }, { "name" "lastmodifiedat", "kind" "optional", "type" "string", "description" "internal cross river value date and time the database entry was last modified the date and time are in this format yyyy mm ddthh\ mm\ ss\[ mmm]" }, { "name" "lasttransactedat", "kind" "optional", "type" "string", "description" "the date and time a transaction last took place on the account the date and time are in this format yyyy mm ddthh\ mm\ ss\[ mmm]" } ] } ] }