Skip to main content
Each auth response includes the standard account fields plus the numbers object, both documented below. The Auth endpoint returns account and routing numbers for a user’s connected financial accounts. Use this data for ACH transfers, wire transfers, and account verification.

​
Attributes

The auth response returns an accounts array. Each account includes the fields below plus a numbers object with account and routing numbers grouped by network type.

​
Account object

AttributeTypeDescription
idstringUnique ID
created_atdate-timeTimestamp when the account was created in Truv
updated_atdate-timeTimestamp when the account was updated in Truv
typestring, nullThe account’s type
subtypestring, nullThe account’s subtype
maskstringLast 4 digits of account number
nicknamestring, nullUser-defined name for the account
is_openbooleanIndicates whether the account is currently open
balancesobjectBalance information, see Balances object
providerstringData provider ID
provider_namestringData provider name
numbersobjectAccount and routing numbers grouped by network type, see Numbers object

​
Numbers object

Each key (ACH, RTP, OTHERS) contains an array of number objects.
AttributeTypeDescription
account_numberstringUnique identifier assigned to the financial account
routing_numberstringUnique identifier for the financial institution, used to route transactions
is_tokenized_account_numberbooleanWhether the account number has been tokenized by the institution

​
Endpoints

​
Example response

{
  "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",
      "is_open": true,
      "balances": {
        "currency_code": "USD",
        "balance": "100.00",
        "available_balance": "50.99",
        "credit_limit": "200.00"
      },
      "provider": "truv",
      "provider_name": "Truv Bank",
      "numbers": {
        "ACH": [
          {
            "account_number": "16002600",
            "routing_number": "123456789",
            "is_tokenized_account_number": true
          }
        ],
        "RTP": [
          {
            "account_number": "16002600",
            "routing_number": "123456789",
            "is_tokenized_account_number": true
          }
        ],
        "OTHERS": [
          {
            "account_number": "16002600",
            "routing_number": "123456789",
            "is_tokenized_account_number": true
          }
        ]
      }
    }
  ]
}