getCustodyFundMoves

Get the list of custody fund move intents for a given custody account

Request Parameters

ParameterRequiredTypeDescription
clientIDyesstringTransactAPI Client ID
developerAPIKeyyesstringTransactAPI Developer Key
accountIdnostringAccount ID that is generated by the API once an account is created (createAccount)

Sample Request

curl -k -X POST https://tapi-sandboxdash.norcapsecurities.com/tapiv3/index.php/v3/getCustodyFundMoves
-d developerAPIKey=somedeveloperkey
-d clientID=someclientid
-d accountId=accountId

Response Parameters

Root Response

FieldTypeDescription
statusCodeStringAPI response code
statusDescStringHuman-readable status description
custodyTransactionObjectTransaction details object

custodyTransaction Object

FieldTypeDescription
accountIdStringInternal account identifier
bankNameStringBank name (nullable)
amountStringTransaction amount with decimal precision
accountNumberStringBank account number
routingNumberStringBank routing number
accountNameStringAccount holder name
referenceNumberStringUnique transaction reference
descriptionStringTransaction description
approvalStatusStringInternal approval status for transaction processing authorization
statusStringCurrent state of the ACH transaction in the payment processing lifecycle
routingNumberStatusStringRouting number validation status
errorsStringError messages (empty if none)
createdDateStringTransaction creation timestamp (YYYY-MM-DD HH:mm:ss)
updatedDateStringLast modification timestamp (YYYY-MM-DD HH:mm:ss)

approvalStatus Values

  • pending - Awaiting approval review
  • declined - Rejected for processing
  • approved - Authorized for processing

Note: Approval decisions are processed daily at 4:00 PM Mountain Time via batch operation.

status Values

  • pending - Transaction created but not yet submitted
  • submitted - Sent to ACH network for processing
  • settled - Successfully completed and funds transferred
  • returned - Rejected by receiving bank
  • voided - Cancelled before settlement
  • declined - Rejected during processing

Sample Response

{
    "statusCode": "101",
    "statusDesc": "Ok",
    "custodyTransactions": [
        {
            "accountId": "A3110006",
            "bankName": null,
            "amount": "7.000000",
            "accountNumber": "",
            "routingNumber": "011001726",
            "accountName": "",
            "referenceNumber": "339846456",
            "description": "",
            "approvalStatus": "approved",
            "status": "Pending",
            "routingNumberStatus": "Verified",
            "errors": "",
            "createdDate": "2024-12-10 22:49:06",
            "updatedDate": "2024-12-10 22:49:06"
        },
        {
            "accountId": "A3110006",
            "bankName": null,
            "amount": "0.000000",
            "accountNumber": "",
            "routingNumber": "011001726",
            "accountName": "",
            "referenceNumber": "417184939",
            "description": "",
            "approvalStatus": "approved",
            "status": "Pending",
            "routingNumberStatus": "Verified",
            "errors": "",
            "createdDate": "2024-12-03 21:56:24",
            "updatedDate": "2024-12-03 21:56:24"
        },
        {
            "accountId": "A3110006",
            "bankName": null,
            "amount": "0.000000",
            "accountNumber": "",
            "routingNumber": "011001726",
            "accountName": "",
            "referenceNumber": "916079744",
            "description": "",
            "approvalStatus": "approved",
            "status": "Pending",
            "routingNumberStatus": "Verified",
            "errors": "",
            "createdDate": "2024-12-03 21:47:21",
            "updatedDate": "2024-12-03 21:47:21"
        },
        {
            "accountId": "A3110006",
            "bankName": null,
            "amount": "100.000000",
            "accountNumber": "MTExMTIyMjIzMzMzMDAwMA==",
            "routingNumber": "MDExMDAxNzI2",
            "accountName": "Chelsea Elting",
            "referenceNumber": "879361244",
            "description": "",
            "approvalStatus": "approved",
            "status": "SETTLED",
            "routingNumberStatus": "Verified",
            "errors": "",
            "createdDate": "2024-11-26 17:06:53",
            "updatedDate": "2024-12-03 21:09:38"
        },
        {
            "accountId": "A3110006",
            "bankName": null,
            "amount": "51.250000",
            "accountNumber": "MTExMTIyMjIzMzMzMDAwMA==",
            "routingNumber": "MDExMDAxNzI2",
            "accountName": "Chelsea Elting",
            "referenceNumber": "520284442",
            "description": "investment in ABC",
            "approvalStatus": "approved",
            "status": "Voided",
            "routingNumberStatus": "Verified",
            "errors": "",
            "createdDate": "2024-10-18 19:13:16",
            "updatedDate": "2024-11-04 23:21:17"
        }
    ],
    "pagination": {
        "totalRecords": 5,
        "startIndex": 0,
        "endIndex": 4
    }
}

Test it Yourself!

Language
Click Try It! to start a request and see the response here!