Accounts API: Debit Card Transaction History

Similar to the Transaction History endpoint, this API endpoint contains a listing of all transaction details for any debit card transactions for the account the member is signed in with. Data responses for this API endpoint is limited to 50 transactions at a time.

API Endpoint

GEThttps://api.itsme247.com/v1.1/accounts/{accountId}/transactions/debitcard

HTTP Headers

Status Key Value
Required CU*Answers-AppKey GUID
Required Accept application/json
Required Content-Type application/json
Optional CU*Answers-CUID 3 digit Credit Union ID

Response


{
  "Transactions": [
    {
      "AccountId": "string",
      "AccountType": "string",
      "AccountDescription": "string",
      "BusinessDate": "2017-04-03T12:43:55.860Z",
      "ActivityDate": "2017-04-03T12:43:55.860Z",
      "Balance": 0,
      "Amount": 0,
      "PrincipalAmount": 0,
      "InterestAmount": 0,
      "PrimaryDescription": "string",
      "SecondaryDescription": "string",
      "TransactionId": 0,
      "CheckNumber": 0,
      "MICR": "string",
      "Tracer": "string",
      "CheckPostedDate": "2017-04-03T12:43:55.860Z",
      "RoutingAndTransit": 0,
      "TransactionDirection": "Debit",
      "TransactionType": "string",
      "IsCheck": true,
      "HasCheckImage": true
    }
  ],
  "MoreDataAvailable": true,
  "CurrentPage": 0,
  "LastPage": 0,
  "PageSize": 0,
  "RecordsOnPage": 0,
  "TotalNumberOfRecords": 0
}
Parameter Type Description
Transactions Array See Below. This is an array of transaction details for the suffix requested.
MoreDataAvailable boolean A true/false flag on whether or not there are more transactions available beyond this call.
CurrentPage integer The current page you are on based on the
LastPage integer The last page number based on the page size requested.
PageSize integer The amount of records per page. This defaults to, and has a max of, 50 records per page.
RecordsOnPage integer The current amount of records for the page requested.
TotalNumberOfRecords integer The total amount of records found for the request.

Transaction History

Parameter Type Description
AccountId string The “Suffix Number” of the account. This is generally a 3 character number, but could contain characters. It could also be longer than that and contain asterisk characters. In those cases, these are considered OTB (Off Trial Balance) accounts and only the last 4 characters will be seen, the rest masked.
AccountType string A short description of what type the suffix you are seeing is. “SAVE”, “LOAN”, etc…
AccountDescription string A “full name” of the suffix. This will contain the suffix code, and a nickname if the member has assigned on to the suffix. Otherwise it will contain the suffix code and a default name of the suffix.
BusinessDate datetime The date at which the transaction was processed by your Credit Union
ActivityDate datetime The date when the transaction was done at the merchant.
Balance decimal The current balance of the sub-account that this transaction is for.
Amount decimal The total amount paid or received for this transaction.
PrincipalAmount decimal Only used when TransactionType = LOAN. The amount of principal paid for this payment transaction.
InterestAmount decimal Only used when TransactionType = LOAN. The amount of interest paid for this payment transaction.
PrimaryDescription string The main description for this transaction.
SecondaryDescription string A secondary description for this transaction.
TransactionId integer An internal identifier for this transaction. Use this field when looking for Individual transactions.
CheckNumber integer Only used when TransactionType = CHEK. The number of the check.
MICR string Only used when TransactionType = CHEK. The MICR of the check, which contains the bank code and account number of the check.
Tracer string Only used when TransactionType = CHEK. Tracer is a unique ID for the check, which is created and assigned by the check processor.
CheckPostedDate datetime Only used when TransactionType = CHEK. The date at which the check was posted to the institution.
RoutingAndTransit decimal Only used when TransactionType = CHEK. The Routing number for this check.
TransactionDirection string If the transaction is a Debit or Credit to the sub-account.
TransactionType string A short description of the type of transaction. SAVE, LOAN, CHEK, etc…
IsCheck boolean Indicates if the transaction is for a check or not.
HasCheckImage boolean Only used if the IsCheck flag is true. Indicates if the transaction has a check image available.

Response Error

Check the error table below for information on the error codes that could be returned


{
  "ErrorCode": "string",
  "DisplayMessage": "string",
  "TechnicalMessage": "string",
  "Timestamp": "datetime""
}

Parameter Type Description
ErrorCode string The ErrorCode is a custom code we use to identify specific areas where something might have not worked right. Write it down and contact us if you continue to have issues.
DisplayMessage string This is generally something you can show to members when an error shows up. Though we encourage you to create your own message table based on the ErrorCode field above. We use these display messages for Online Banking, so you might see something tailored to a different application.
TechnicalMessage string This is a more detailed, developer-type message that migth help you in determining more of what’s going on. This should never be displayed to the member.
Timestamp datetime The date and time of the error. This is useful information to provide CU*Answers, should you need to contact us.

Error Codes

Code HTTP Code Description
OT12345764 500 Invalid characters were found within the challenge question. [ , ^, ]
SC12345915 500 Invalid challenge question length. Minimum of 3 characters.
NO12345749 500 Challenge question has an inappropriate word within the text.
SC12345913 500 Invalid security answers. Answers must be at least 3 characters.
NA12345747 500 Challenge questions must all be different.
NO12345749 500 Challenge answer has an inappropriate word within the text.
OT12345765 500 Invalid characters were found within the challenge answers. [ , ^, ]
ST12345702 500 Credit union not available during stand-in processing for end of day.
PC12345705 500 Member not authorized to access account based on PIB profile access times.
NF12345748 500 Missing Vendor login script. Contact CU*Answers.
NF12345734 500 Invalid Credit Union Id.
NF12345704 500 Application keys not found. Contact CU*Answers.
NA12345746 500 Online banking is not active for this Credit Union.
9999999999 500 Requested data not found.
8888888888 403 Requested data not found.
API2000 403 Forbidden: You are not authorized to use this resource.
API2010 403 Forbidden: You are not authorized to use this resource.
API2011 403 Forbidden: You are not authorized to use this resource. Whitelist Issue.
API2012 403 Forbidden: You are not authorized to use this resource.
API2013 403 Forbidden: You are not authorized to use the Accounts API.
API2014 403 Forbidden: You are not authorized to use the Members API.
API2015 403 Forbidden: You are not authorized to use the CreditUnions API.
API2016 403 Forbidden: You are not authorized to use the Transfers API.
API4000 403 Forbidden: You are not authorized to use this resource.
HTTP404 404 The location requested could not be found.
HTTP415 400 The media type requested is not supported. Please use application/json.
OB110 400 The AppKey is missing.
OB111 400 The session token is missing.
OB112 400 The user token is missing.
OB113 403 The id is missing.
OB201 403 The AppKey provided could not be verified.
OB202 403 The AppKey provided could not be verified against the credit union id.
OB203 403 Mismatch between AppKey and credit union id.
OB204 400 Credit union id could not be found. Please validate HttpHeader parameters are valid.
OB310 403 Data received is incomplete. Please validate the data being sent in and try again.
OB500 503 Online access is currently disabled, please try again later or contact the Credit Union for assistance.
OB503 500 [This message changes based on CU Configuration for maintenance]
OB510 500 Data could not be retrieved for this request, please try again or contact the Credit Union for assistance.
OB511 500 Data could not be retrieved for this request, please try again.
SC12345684 500 There was a problem processing your request. Please try again or contact CU*Answers.
NA12345746 500 Online banking is not active for this Credit Union.
NF12345703 500 There was a problem processing your request. Please try again or contact CU*Answers.
NF12345912 500 Data for savings account type not found.
SC12345735 401 Member not authenticated. Steps need completing.