> ## Documentation Index > Fetch the complete documentation index at: https://docs.truv.com/llms.txt > Use this file to discover all available pages before exploring further. # Retrieve auth data > The endpoint retrieves a list of connected financial accounts, including their bank identification numbers. ## OpenAPI ````yaml GET /v1/links/{link_id}/auth/ openapi: 3.0.1 info: title: Truv API description: Truv API Documentation termsOfService: https://www.truv.com/legal/terms-of-use contact: email: support@truv.com version: v1 servers: - url: https://prod.truv.com security: - ClientID: [] AccessKey: [] tags: - name: Users - name: Bridge Token - name: Companies and Data Providers - name: Key Management - name: Account Links - name: Data Refresh - name: Customization Templates - name: Webhooks - name: Orders - name: Tasks - name: VOIE Reports - name: VOA Reports - name: Income Insights Reports - name: DDS Reports - name: Employment - name: Identity - name: Shifts - name: Pay Statements - name: Tax Documents - name: Parsed Documents - name: Reports - name: Uploaded Documents - name: Bank Accounts - name: Bank Statements - name: Deposit Switch Reports - name: Insurance Reports - name: Income Report - name: Scoring Attributes - name: Accounts - name: Transactions - name: Recurring Transactions - name: Document Collections paths: /v1/links/{link_id}/auth/: parameters: - name: link_id in: path description: Link ID required: true schema: type: string example: 24d7e80942ce4ad58a93f70ce4115f5c get: tags: - Accounts summary: Retrieve auth data description: >- The endpoint retrieves a list of connected financial accounts, including their bank identification numbers. operationId: bank-auth-get parameters: - name: account_ids in: query description: Comma-separated list of account IDs to filter required: false schema: type: string responses: '200': description: '' content: application/json: schema: $ref: '#/components/schemas/AuthGetResponse' '401': description: HTTP 401 Unauthorized content: application/json: schema: $ref: '#/components/schemas/Error401' '403': description: HTTP 403 Forbidden content: application/json: schema: $ref: '#/components/schemas/Error403' components: schemas: AuthGetResponse: required: - accounts type: object properties: accounts: type: array items: $ref: '#/components/schemas/FinancialAccountAuthGet' Error401: description: '' type: object properties: error: description: '' type: object properties: code: description: '' type: string example: authentication_failed message: description: '' type: string example: No such token Error403: description: '' type: object properties: error: description: '' type: object properties: code: description: '' type: string example: not_authenticated message: description: '' type: string example: Authentication credentials were not provided. FinancialAccountAuthGet: required: - type - subtype - mask - balances - provider - provider_name type: object properties: id: description: Unique ID type: string readOnly: true example: 24d7e80942ce4ad58a93f70ce4115f5c created_at: description: >- The date and time when the account was first created in Truv, specified in ISO 8601 format. type: string format: date-time readOnly: true example: '2022-05-04T11:30:00Z' updated_at: description: >- The date and time of the most recent update made to the account in Truv, in ISO 8601 format. type: string format: date-time readOnly: true example: '2022-05-04T12:00:00Z' type: description: The type of the account. type: string enum: - CHECKING - SAVINGS - LOAN - CREDIT_CARD - INVESTMENT - LINE_OF_CREDIT - MORTGAGE - PROPERTY - CASH - INSURANCE - PREPAID - CHECKING_LINE_OF_CREDIT - null readOnly: true example: CHECKING nullable: true subtype: description: The subtype of the account. type: string enum: - MONEY_MARKET - CERTIFICATE_OF_DEPOSIT - AUTO - STUDENT - SMALL_BUSINESS - PERSONAL - PERSONAL_WITH_COLLATERAL - HOME_EQUITY - BOAT - POWERSPORTS - RV - HELOC - PLAN_401_K - PLAN_403_B - PLAN_529 - IRA - ROLLOVER_IRA - ROTH_IRA - TAXABLE - NON_TAXABLE - BROKERAGE - TRUST - UNIFORM_GIFTS_TO_MINORS_ACT - PLAN_457 - PENSION - EMPLOYEE_STOCK_OWNERSHIP_PLAN - SIMPLIFIED_EMPLOYEE_PENSION - SIMPLE_IRA - PLAN_ROTH_401_K - FIXED_ANNUITY - VARIABLE_ANNUITY - HSA - TAX_FREE_SAVINGS_ACCOUNT - INDIVIDUAL - REGISTERED_RETIREMENT_INCOME_FUND - CASH_MANAGEMENT_ACCOUNT - EMPLOYEE_STOCK_PURCHASE_PLAN - REGISTERED_EDUCATION_SAVINGS_PLAN - PROFIT_SHARING_PLAN - UNIFORM_TRANSFER_TO_MINORS_ACT - PLAN_401_A - SARSEP_IRA - FIXED_ANNUITY_TRADITIONAL_IRA - VARIABLE_ANNUITY_TRADITIONAL_IRA - SEPP_IRA - INHERITED_TRADITIONAL_IRA - FIXED_ANNUITY_ROTH_IRA - VARIABLE_ANNUITY_ROTH_IRA - INHERITED_ROTH_IRA - COVERDELL - ADVISORY_ACCOUNT - BROKERAGE_MARGIN - CHARITABLE_GIFT_ACCOUNT - CHURCH_ACCOUNT - CONSERVATORSHIP - CUSTODIAL - DEFINED_BENEFIT_PLAN - DEFINED_CONTRIBUTION_PLAN - EDUCATIONAL - ESTATE - EXECUTOR - GROUP_RETIREMENT_SAVINGS_PLAN - GUARANTEED_INVESTMENT_CERTIFICATE - HRA - INDEXED_ANNUITY - INVESTMENT_CLUB - IRREVOCABLE_TRUST - JOINT_TENANTS_BY_ENTIRITY - JOINT_TENANTS_COMMUNITY_PROPERTY - JOINT_TENANTS_IN_COMMON - JOINT_TENANTS_WITH_RIGHTS_OF_SURVIVORSHIP - KEOUGH_PLAN - LIFE_INCOME_FUND - LIVING_TRUST - LOCKED_IN_RETIREMENT_ACCOUNT - LOCKED_IN_RETIREMENT_INVESTMENT_FUND - LOCKED_IN_RETIREMENT_SAVINGS_ACCOUNT - MONEY_PURCHASE_PLAN - PARTNERSHIP - PLAN_409_A - PLAN_ROTH_403_B - REGISTERED_DISABILITY_SAVINGS_PLAN - REGISTERED_LOCKED_IN_SAVINGS_PLAN - REGISTERED_PENSION_PLAN - REGISTERED_RETIREMENT_SAVINGS_PLAN - REVOCABLE_TRUST - ROTH_CONVERSION - SOLE_PROPRIETORSHIP - SPOUSAL_IRA - SPOUSAL_ROTH_IRA - TESTAMENTARY_TRUST - THRIFT_SAVINGS_PLAN - INHERITED_ANNUITY - CORPORATE_ACCOUNT - LIMITED_LIABILITY_ACCOUNT - VEHICLE_INSURANCE - DISABILITY - HEALTH - LONG_TERM_CARE - PROPERTY_AND_CASUALTY - UNIVERSAL_LIFE - TERM_LIFE - WHOLE_LIFE - ACCIDENTAL_DEATH_AND_DISMEMBERMENT - VARIABLE_UNIVERSAL_LIFE - ROTH - ROLLOVER - OTHER - ANNUITY - TRANSFERRABLE_ON_DEATH - null readOnly: true example: MONEY_MARKET nullable: true mask: description: The last four digits of the account number. type: string readOnly: true example: '6789' nickname: description: A user-defined name or label for the account. type: string readOnly: true example: My account nullable: true is_open: description: Indicates whether the account is currently open. type: boolean readOnly: true balances: $ref: '#/components/schemas/AccountBalances' provider: description: Data provider ID. type: string readOnly: true example: truv provider_name: description: Data provider name. type: string readOnly: true example: Truv Bank numbers: description: >- An object that holds identifying numbers associated with the account used for processing electronic transfers. This includes numbers necessary for initiating or receiving funds between accounts. type: object properties: ACH: description: List of all ACH numbers identifying accounts. type: array items: type: object properties: account_number: description: >- Account number. A unique identifier assigned to a financial account for tracking and managing transactions, providing essential information for financial operations. type: string example: '16002600' routing_number: description: >- Routing number. A unique identifier for a financial institution. It is used to route and process transactions, ensuring accurate and secure transfers of funds. type: string example: '123456789' is_tokenized_account_number: description: >- Indicates whether the account number has been tokenized by the institution, providing an additional layer of security for transactions. type: boolean example: true readOnly: true RTP: description: List of all RTP numbers identifying accounts. type: array items: type: object properties: account_number: description: >- Account number. A unique identifier assigned to a financial account for tracking and managing transactions, providing essential information for financial operations. type: string example: '16002600' routing_number: description: >- Routing number. A unique identifier for a financial institution. It is used to route and process transactions, ensuring accurate and secure transfers of funds. type: string example: '123456789' is_tokenized_account_number: description: >- Indicates whether the account number has been tokenized by the institution, providing an additional layer of security for transactions. type: boolean example: true readOnly: true OTHERS: description: List of all numbers identifying accounts. type: array items: type: object properties: account_number: description: >- Account number. A unique identifier assigned to a financial account for tracking and managing transactions, providing essential information for financial operations. type: string example: '16002600' routing_number: description: >- Routing number. A unique identifier for a financial institution. It is used to route and process transactions, ensuring accurate and secure transfers of funds. type: string example: '123456789' is_tokenized_account_number: description: >- Indicates whether the account number has been tokenized by the institution, providing an additional layer of security for transactions. type: boolean example: true readOnly: true AccountBalances: type: object properties: currency_code: description: Currency type: string readOnly: true example: USD balance: description: Balance amount type: string format: decimal readOnly: true example: '100.00' nullable: true available_balance: description: Available balance amount type: string format: decimal readOnly: true example: '50.99' nullable: true credit_limit: description: Credit limit type: string format: decimal readOnly: true example: '200.00' nullable: true securitySchemes: ClientID: type: apiKey description: Client ID name: X-Access-Client-Id in: header AccessKey: type: apiKey description: Client Access Key name: X-Access-Secret in: header ````