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

Attribute	Type	Description
`id`	string	Unique ID
`created_at`	date-time	Timestamp when the account was created in Truv
`updated_at`	date-time	Timestamp when the account was updated in Truv
`type`	string, null	The account’s type
`subtype`	string, null	The account’s subtype
`mask`	string	Last 4 digits of account number
`nickname`	string, null	User-defined name for the account
`is_open`	boolean	Indicates whether the account is currently open
`balances`	object	Balance information, see Balances object
`provider`	string	Data provider ID
`provider_name`	string	Data provider name
`numbers`	object	Account and routing numbers grouped by network type, see Numbers object

Numbers object

Each key (ACH, RTP, OTHERS) contains an array of number objects.

Attribute	Type	Description
`account_number`	string	Unique identifier assigned to the financial account
`routing_number`	string	Unique identifier for the financial institution, used to route transactions
`is_tokenized_account_number`	boolean	Whether the account number has been tokenized by the institution

Endpoints

Retrieve auth data

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
          }
        ]
      }
    }
  ]
}

​Attributes

​Account object

​Numbers object

​Endpoints

​Example response

Attributes

Account object

Numbers object

Endpoints

Example response