Transactions

Learn about transactions from accounts in a financial institution.

Attributes

The information in this table is for the transactions response.

AttributeTypeDescription
countintegerCount
nexturiNext
previousuriPrevious
accountsarray of objectsList of accounts, see Accounts object
transactionsarray of objectsList of transactions, see Transactions object

Accounts object

Use the table below for reference to the account object values.

AttributeTypeDescription
idstringUnique identifier of account
created_atdate-timeDate and time account was created
updated_atdate-timeDate and time account was most recently updated
typestringParent type of the account
subtypestringAccount subtype
maskstringMasked banking account number associated with account
nicknamestringAlternate name for account
balancesarray of objectsList of balance information, see Balances object

Balances object

Find information about the balances object values in the table below.

AttributeTypeDescription
currency_codestringCurrency
balancestringBalance amount
available_balancestringAvailable balance amount
credit_limitstringCredit limit

Transactions object

The values in this table have information from the transactions object.

AttributeTypeDescription
idstringUnique identifier of transaction
created_atdate-timeTimestamp when transaction was created in Truv
updated_atdate-timeTimestamp when transaction was last updated in Truv
account_idstringaccount_id
external_idstringExternal system transaction identifier
amountstringMonetary amount of transaction
currency_codestringThree-character ISO 4217 currency code
check_numberstringCheck number for transaction
categoriesarray of stringsList of categories assigned to this transaction
descriptionstringHuman-readable transaction description
statusstringStatus of transaction, either POSTED or PENDING
typestringType of transaction, either CREDIT or DEBIT
posted_atdate-timeTimestamp for movement of funds
transacted_atdate-timeTimestamp when transaction occurred
memostringAdditional descriptive information about transaction
merchant_category_codestringISO 18245 category code for transaction
locationobjectLocation, see Location object

Location object

The two values in this table are for the location object.

AttributeTypeDescription
latitudefloatLatitude
longitudefloatLongitude

Endpoints

Use the endpoint below for information about transactions in an account.

Example response

The sample below is a JSON response for the endpoint.

{
  "count": 0,
  "next": "string",
  "previous": "string",
  "accounts": [
    {
      "id": "24d7e80942ce4ad58a93f70ce4115f5c",
      "created_at": "2022-05-04T11:30:00Z",
      "updated_at": "2022-05-04T12:00:00Z",
      "type": "CHECKING",
      "subtype": "MONEY_MARKET",
      "mask": "6789",
      "nickname": "My account",
      "balances": {
        "currency_code": "USD",
        "balance": "100.00",
        "available_balance": "50.99",
        "credit_limit": "200.00"
      }
    }
  ],
  "transactions": [
    {
      "id": "24d7e80942ce4ad58a93f70ce4115f5c",
      "created_at": "2022-05-04T11:30:00Z",
      "updated_at": "2022-05-04T12:00:00Z",
      "account_id": "68a7e80942ce4ad58a93f70ce411549a",
      "external_id": "external_key_243901",
      "amount": "100.00",
      "currency_code": "USD",
      "check_number": "123456",
      "categories": [
        "Transfer"
      ],
      "description": "Some transaction",
      "status": "POSTED",
      "type": "DEBIT",
      "posted_at": "2022-05-04T11:30:00Z",
      "transacted_at": "2022-05-04T11:30:00Z",
      "memo": "",
      "merchant_category_code": 5967,
      "location": {
        "latitude": "40.730610",
        "longitude": "-73.935242"
      }
    }
  ]
}