Access details for checking, savings, credit, loan, and investment accounts. Seamlessly access account information for Truist clients. Truist publishes an OpenAPI 3.1.0 contract (v2.6.0) for this product on the Truist Developer Center.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/personal-small-business-accounts"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.1.0
info:
version: '2.6.0'
# build: '1'
title: Personal and Small Business Accounts
description: Truist Financial, following FDX V5.4.1 Core API
contact:
name: Truist API Support
url: 'https://developer.truist.com/contact-us'
x-fdx-csdf-account-categories: [ANY]
servers:
- url: 'https://api-sandbox.truist.com/retail'
description: Truist Financial Retail Open Banking APIs - Sandbox environment
- url: 'https://apicert-secure.truist.com/retail'
description: Truist Financial Retail Open Banking APIs - Certification environment
- url: 'https://api-secure.truist.com/retail'
description: Truist Financial Retail Open Banking APIs - Production environment
security:
- OAuth: [ACCOUNT_BASIC, ACCOUNT_DETAILED]
tags:
- name: Account Information
description: Search and view customer accounts
paths:
############################################################
#
# Core paths
#
############################################################
/v2/accounts:
parameters:
- $ref: '#/components/parameters/FapiInteractionIdHeader'
- $ref: '#/components/parameters/FdxApiActorTypeHeader'
x-fdx-csdf-account-categories: [ANY]
get:
operationId: searchForAccounts
tags:
- Account Information
summary: Search for accounts
description: Query all information for user accounts
x-fdx-csdf-account-categories: [ANY]
parameters:
- $ref: '#/components/parameters/ResultTypeQuery'
responses:
'200':
description: Array of accounts
headers:
x-fapi-interaction-id:
$ref: '#/components/headers/x-fapi-interaction-id'
content:
application/json:
schema:
$ref: '#/components/schemas/Accounts'
examples:
accountList-resultType-as-details:
summary: resultType as details
value:
accounts:
- depositAccount:
accountId: uYrD4LD7P9948lzy3UCPHLWljGqcRWx06Tr
accountNumber: '***************11111'
accountCategory: DEPOSIT_ACCOUNT
accountType: CHECKING
nickname: Checking 1111
routingTransitNumber: '053101121'
accountNumberDisplay: '***************11111'
status: OPEN
balanceAsOf: '2022-03-17T00:00:00.000Z'
currentBalance: 48302.6
availableBalance: 48300.6
currency:
currencyCode: USD
contact:
holders:
- relationship: PRIMARY
interestRate: 0.01
transferIn: true
transferOut: true
billPayStatus: ACTIVE
- depositAccount:
accountId: CD69feLdRMb8EskxYG2KepL4XLiSnOFRyyT
accountNumber: '***************22222'
accountCategory: DEPOSIT_ACCOUNT
accountType: SAVINGS
nickname: nickname 2222
routingTransitNumber: '053101121'
accountNumberDisplay: '***************22222'
status: OPEN
balanceAsOf: '2022-03-17T00:00:00.000Z'
currentBalance: 1402.23
availableBalance: 1400.23
currency:
currencyCode: USD
contact:
holders:
- relationship: PRIMARY
interestRate: 0.01
transferIn: true
transferOut: true
billPayStatus: NOT_AVAILABLE
- depositAccount:
accountId: we3CrAgVWYks1hhQTjWOlROIxaY4SXoy45e
accountNumber: '***************33333'
accountCategory: DEPOSIT_ACCOUNT
accountType: CD
nickname: CD 3333
routingTransitNumber: '053201607'
accountNumberDisplay: '***************3333'
status: OPEN
balanceAsOf: '2022-03-17T00:00:00.000Z'
currentBalance: 32613.85
availableBalance: 0.0
currency:
currencyCode: USD
contact:
holders:
- relationship: PRIMARY
interestRate: 0.01
transferIn: false
transferOut: false
billPayStatus: NOT_AVAILABLE
- locAccount:
accountId: 300ucQsGTV9Tlm2Sl3yy2hF4x60OmrFCerw
accountNumber: '***************66666'
accountCategory: LOC_ACCOUNT
accountType: CREDITCARD
nickname: Visa Card 6666
routingTransitNumber: '053101121'
accountNumberDisplay: '***************66666'
status: OPEN
balanceAsOf: '2022-03-17T00:00:00.000Z'
currentBalance: 100.0
availableBalance: 900.0
currency:
currencyCode: USD
contact:
holders:
- relationship: PRIMARY
interestRate: 0.0
transferIn: true
transferOut: true
billPayStatus: NOT_AVAILABLE
- locAccount:
accountId: Y4qEwEk62xYOrpKIEssEk6ztpCOQdhfXtle
accountNumber: '***************77777'
accountCategory: LOC_ACCOUNT
accountType: CREDITCARD
nickname: Master Card 7777
routingTransitNumber: '053101121'
accountNumberDisplay: '***************77777'
status: OPEN
balanceAsOf: '2022-03-17T00:00:00.000Z'
currentBalance: 1834.57
availableBalance: 23165.0
currency:
currencyCode: USD
contact:
holders:
- relationship: PRIMARY
interestRate: 0.0
transferIn: true
transferOut: true
billPayStatus: NOT_AVAILABLE
- locAccount:
accountId: PsBgRpTAT66ogdvy0wAa3qFZNpiDigawtQS
accountNumber: '***************08888'
accountCategory: LOC_ACCOUNT
accountType: LINEOFCREDIT
nickname: Credit Line 8888 08888
routingTransitNumber: '053101121'
accountNumberDisplay: '***************88888'
status: OPEN
balanceAsOf: '2022-03-17T00:00:00.000Z'
currentBalance: 230.86
availableBalance: 249769.6
currency:
currencyCode: USD
contact:
holders:
- relationship: PRIMARY
interestRate: 0.0
transferIn: true
transferOut: true
billPayStatus: NOT_AVAILABLE
- locAccount:
accountId: apPAcDP0EJZpFYM9cAJCe2k0DENEX4rjGOO
accountNumber: '***************99999'
accountCategory: LOC_ACCOUNT
accountType: LINEOFCREDIT
nickname: Home Equity Line 9999
routingTransitNumber: '051503394'
accountNumberDisplay: '***************99999'
status: OPEN
balanceAsOf: '2022-03-17T00:00:00.000Z'
currentBalance: 31869.32
availableBalance: 12258.61
currency:
currencyCode: USD
contact:
holders:
- relationship: PRIMARY
interestRate: 0.0
transferIn: true
transferOut: true
billPayStatus: NOT_AVAILABLE
- loanAccount:
accountId: YEseynEIcdFdAkyDWllqMJ3Yu7tGUPmARot
accountNumber: '***************10010'
accountCategory: LOAN_ACCOUNT
accountType: PERSONALLOAN
nickname: Loan 10010/NC Land
routingTransitNumber: '053101121'
accountNumberDisplay: '***************10010'
status: OPEN
balanceAsOf: '2022-03-17T00:00:00.000Z'
currentBalance: 13757.84
availableBalance: 485.19
currency:
currencyCode: USD
contact:
holders:
- relationship: PRIMARY
interestRate: 4.25
transferIn: false
transferOut: true
billPayStatus: NOT_AVAILABLE
- loanAccount:
accountId: 35igCYFycMrL0l470ny9wuE5mMoa2LXOoas
accountNumber: '***************11011'
accountCategory: LOAN_ACCOUNT
accountType: MORTGAGE
nickname: Mortgage 1011
routingTransitNumber: '053101121'
accountNumberDisplay: '***************11011'
status: OPEN
balanceAsOf: '2022-03-17T00:00:00.000Z'
currentBalance: 2130.29
availableBalance: 948.36
currency:
currencyCode: USD
contact:
holders:
- relationship: PRIMARY
interestRate: 0.0
transferIn: false
transferOut: true
billPayStatus: NOT_AVAILABLE
- investmentAccount:
accountId: MNAQSglxnPDZk4ccuQ7qV8mP
accountNumber: '*******12012'
accountCategory: INVESTMENT_ACCOUNT
accountType: BROKERAGEPRODUCT
nickname: Investments 2012
routingTransitNumber: '053101121'
accountNumberDisplay: '*******12012'
status: OPEN
balanceAsOf: '2022-03-17T00:00:00.000Z'
currentBalance: 140037.25
availableBalance: 140037.25
currency:
currencyCode: USD
interestRate: 0.0
transferIn: true
transferOut: true
billPayStatus: NOT_AVAILABLE
- investmentAccount:
accountId: ras1TIme7BN6bKcnZBnYVmPrzvBSO7w42ft
accountNumber: '***************13013'
accountCategory: INVESTMENT_ACCOUNT
accountType: TRUST
nickname: IRA 3013
routingTransitNumber: '053101121'
accountNumberDisplay: '***************13013'
status: OPEN
balanceAsOf: '2022-03-17T00:00:00.000Z'
currentBalance: 729870.95
availableBalance: 785556.76
currency:
currencyCode: USD
interestRate: 0.0
transferIn: false
transferOut: false
billPayStatus: NOT_AVAILABLE
- investmentAccount:
accountId: cccoayXSAFQhGaFgjSbzJdDOayMIXSHU64e
accountNumber: '***************14014'
accountCategory: INVESTMENT_ACCOUNT
accountType: IRA
nickname: IRA 4014
routingTransitNumber: '053101121'
accountNumberDisplay: '***************14014'
status: OPEN
balanceAsOf: '2022-03-17T00:00:00.000Z'
currentBalance: 27775.64
availableBalance: 0.0
currency:
currencyCode: USD
interestRate: 0.2
transferIn: false
transferOut: false
billPayStatus: NOT_AVAILABLE
- investmentAccount:
accountId: BFFS5lQdx8yXRVj8wkY6
accountNumber: '****15015'
accountCategory: INVESTMENT_ACCOUNT
accountType: BROKERAGEPRODUCT
nickname: Scott Stringfellow 5015
routingTransitNumber: '053101121'
accountNumberDisplay: '****15015'
status: OPEN
balanceAsOf: '2022-03-17T00:00:00.000Z'
currentBalance: 50689.0
availableBalance: 50689.0
currency:
currencyCode: USD
interestRate: 0.2
transferIn: true
transferOut: true
billPayStatus: NOT_AVAILABLE
accountList-resultType-as-lightweight:
summary: resultType as lightweight
value:
accounts:
- depositAccount:
accountId: uYrD4LD7P9948lzy3UCPHLWljGqcRWx06Tr
accountCategory: DEPOSIT_ACCOUNT
accountType: CHECKING
nickname: Checking 1111
status: OPEN
balanceAsOf: '2022-03-17T00:00:00.000Z'
currentBalance: 48302.6
- depositAccount:
accountId: CD69feLdRMb8EskxYG2KepL4XLiSnOFRyyT
accountCategory: DEPOSIT_ACCOUNT
accountType: SAVINGS
nickname: nickname 2222
status: OPEN
balanceAsOf: '2022-03-17T00:00:00.000Z'
currentBalance: 1402.23
- depositAccount:
accountId: we3CrAgVWYks1hhQTjWOlROIxaY4SXoy45e
accountCategory: DEPOSIT_ACCOUNT
accountType: CD
nickname: CD 3333
status: OPEN
balanceAsOf: '2022-03-17T00:00:00.000Z'
currentBalance: 32613.85
- locAccount:
accountId: 300ucQsGTV9Tlm2Sl3yy2hF4x60OmrFCerw
accountCategory: LOC_ACCOUNT
accountType: CREDITCARD
nickname: Visa Card 6666
status: OPEN
balanceAsOf: '2022-03-17T00:00:00.000Z'
currentBalance: 100.0
- locAccount:
accountId: Y4qEwEk62xYOrpKIEssEk6ztpCOQdhfXtle
accountCategory: LOC_ACCOUNT
accountType: CREDITCARD
nickname: Master Card 7777
status: OPEN
balanceAsOf: '2022-03-17T00:00:00.000Z'
currentBalance: 1834.57
- locAccount:
accountId: PsBgRpTAT66ogdvy0wAa3qFZNpiDigawtQS
accountCategory: LOC_ACCOUNT
accountType: LINEOFCREDIT
nickname: Credit Line 8888 08888
status: OPEN
balanceAsOf: '2022-03-17T00:00:00.000Z'
currentBalance: 230.86
- locAccount:
accountId: apPAcDP0EJZpFYM9cAJCe2k0DENEX4rjGOO
accountCategory: LOC_ACCOUNT
accountType: LINEOFCREDIT
nickname: Home Equity Line 9999
status: OPEN
balanceAsOf: '2022-03-17T00:00:00.000Z'
currentBalance: 31869.32
- loanAccount:
accountId: YEseynEIcdFdAkyDWllqMJ3Yu7tGUPmARot
accountCategory: LOAN_ACCOUNT
accountType: PERSONALLOAN
nickname: Loan 10010/NC Land
status: OPEN
balanceAsOf: '2022-03-17T00:00:00.000Z'
currentBalance: 13757.84
- loanAccount:
accountId: 35igCYFycMrL0l470ny9wuE5mMoa2LXOoas
accountCategory: LOAN_ACCOUNT
accountType: MORTGAGE
nickname: Mortgage 1011
status: OPEN
balanceAsOf: '2022-03-17T00:00:00.000Z'
currentBalance: 2130.29
- investmentAccount:
accountId: MNAQSglxnPDZk4ccuQ7qV8mP
accountCategory: INVESTMENT_ACCOUNT
accountType: BROKERAGEPRODUCT
nickname: Investments 2012
status: OPEN
balanceAsOf: '2022-03-17T00:00:00.000Z'
currentBalance: 140037.25
- investmentAccount:
accountId: ras1TIme7BN6bKcnZBnYVmPrzvBSO7w42ft
accountCategory: INVESTMENT_ACCOUNT
accountType: TRUST
nickname: IRA 3013
status: OPEN
balanceAsOf: '2022-03-17T00:00:00.000Z'
currentBalance: 729870.95
- investmentAccount:
accountId: cccoayXSAFQhGaFgjSbzJdDOayMIXSHU64e
accountCategory: INVESTMENT_ACCOUNT
accountType: IRA
nickname: IRA 4014
status: OPEN
balanceAsOf: '2022-03-17T00:00:00.000Z'
currentBalance: 27775.64
- investmentAccount:
accountId: BFFS5lQdx8yXRVj8wkY6
accountCategory: INVESTMENT_ACCOUNT
accountType: BROKERAGEPRODUCT
nickname: Scott Stringfellow 5015
status: OPEN
balanceAsOf: '2022-03-17T00:00:00.000Z'
currentBalance: 50689.0
'400':
description: Bad Request
headers:
x-fapi-interaction-id:
$ref: '#/components/headers/x-fapi-interaction-id'
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
examples:
INVALID_RESULTTYPE:
value:
code: '401'
message: Bad request. resultType must either be lightweight or details
INVALID_SCOPE:
value:
code: '401'
message: missing or invalid scope
INVALID_JSON:
value:
code: '401'
message: The request payload is not in a valid JSON format
'401':
$ref: '#/components/responses/401'
'403':
description: Forbidden
headers:
x-fapi-interaction-id:
$ref: '#/components/headers/x-fapi-interaction-id'
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
examples:
INVALID_COUNTRY_ID:
value:
code: '403'
message: Service is not whitelisted for this country
INVALID_ORIGIN:
value:
code: '403'
message: Invalid origin
INVALID_IP:
value:
code: '403'
message: Invalid IP
INVALID_SCOPE:
value:
code: '602'
message: Customer connection does not authorize account basic or account details
NO_APIPRODUCT_MATCHFOUND:
value:
code: '403'
message: Data recipient connection does not include account basic or account details
'404':
description: Not Found
headers:
x-fapi-interaction-id:
$ref: '#/components/headers/x-fapi-interaction-id'
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
examples:
RESOURCE_NOT_FOUND:
value:
code: '701'
message: URI does not represent a recognised resource
ACCOUNT_NOT_FOUND:
value:
code: '701'
message: Account not found
CUSTOMER_NOT_FOUND:
value:
code: '601'
message: Customer not found
'405':
$ref: '#/components/responses/405'
'409':
$ref: '#/components/responses/409'
'429':
$ref: '#/components/responses/429'
'500':
$ref: '#/components/responses/500'
'503':
$ref: '#/components/responses/503'
'504':
$ref: '#/components/responses/504'
security:
- OAuth: [ACCOUNT_BASIC]
/v2/accounts/{accountId}:
parameters:
- $ref: '#/components/parameters/FapiInteractionIdHeader'
- $ref: '#/components/parameters/FdxApiActorTypeHeader'
x-fdx-csdf-account-categories: [ANY]
get:
operationId: getAccount
tags:
- Account Information
summary: Get an account
description: Get a specific account
x-fdx-csdf-account-categories: [ANY]
parameters:
- $ref: '#/components/parameters/AccountIdPath'
responses:
'200':
description: >-
This can be one of DepositAccount, LoanAccount, LocAccount or InvestmentAccount
headers:
x-fapi-interaction-id:
$ref: '#/components/headers/x-fapi-interaction-id'
content:
application/json:
schema:
$ref: '#/components/schemas/AccountWithDetails'
examples:
Checking-DepositAccount:
summary: Checking Deposit Account
value:
depositAccount:
accountId: uYrD4LD7P9948lzy3UCPHLWljGqcRWx06Tr
accountCategory: DEPOSIT_ACCOUNT
accountType: CHECKING
accountNumber: '***************11111'
accountNumberDisplay: '***************11111'
productName: Classic Checking
status: OPEN
currency:
currencyCode: USD
lineOfBusiness: CONSUMER
routingTransitNumber: '053101121'
balanceType: ASSET
contact:
holders:
- relationship: PRIMARY
interestRate: 0.01
annualPercentageYield: 0.01
lastActivityDate: '2021-12-06'
balanceAsOf: '2022-03-17T00:00:00.000Z'
currentBalance: 48302.6
availableBalance: 48302.6
Saving-DepositAccount:
summary: Saving Deposit Account
value:
depositAccount:
accountId: CD69feLdRMb8EskxYG2KepL4XLiSnOFRyyT
accountCategory: DEPOSIT_ACCOUNT
accountType: SAVINGS
accountNumber: '***************22222'
accountNumberDisplay: '***************22222'
productName: PERSONAL REGULAR SAVINGS RATE
status: OPEN
currency:
currencyCode: USD
lineOfBusiness: CONSUMER
routingTransitNumber: '053101121'
balanceType: ASSET
contact:
holders:
- relationship: PRIMARY
interestRate: 0.01
annualPercentageYield: 0.01
lastActivityDate: '2022-02-14'
balanceAsOf: '2022-03-17T00:00:00.000Z'
currentBalance: 1402.23
availableBalance: 1402.23
CD-DepositAccount:
summary: Certificate of Deposit (CD) Account
value:
depositAccount:
accountId: we3CrAgVWYks1hhQTjWOlROIxaY4SXoy45e
accountCategory: DEPOSIT_ACCOUNT
accountType: CD
accountNumber: '***************33333'
accountNumberDisplay: '***************33333'
status: OPEN
currency:
currencyCode: USD
balanceType: ASSET
interestRate: 0.01
annualPercentageYield: 0.01
lastActivityDate: '2022-03-16'
balanceAsOf: '2022-03-17T00:00:00.000Z'
currentBalance: 32613.85
availableBalance: 32613.85
interestYtd: 0.8
term: 6
maturityDate: '2022-09-16'
CreditCard-locAccount:
summary: Credit Card
value:
locAccount:
accountId: 300ucQsGTV9Tlm2Sl3yy2hF4x60OmrFCerw
accountCategory: LOC_ACCOUNT
accountType: CREDITCARD
accountNumber: '***************66666'
accountNumberDisplay: '***************66666'
productName: COMMERCIAL Corporate Executive
status: OPEN
currency:
currencyCode: USD
balanceType: LIABILITY
contact:
holders:
- relationship: PRIMARY
balanceAsOf: '2022-03-17T00:00:00.000Z'
creditLine: 1000.0
availableCredit: 900.0
nextPaymentDate: '2022-04-03'
currentBalance: 100.0
minimumPaymentAmount: 0.0
lastPaymentAmount: 0.0
lastPaymentDate: '9999-01-01'
pastDueAmount: 0.0
lastStmtBalance: 100.0
lastStmtDate: '2022-03-09'
cashAdvanceLimit: 1000.0
availableCash: 900.0
financeCharges: 0.0
cardNetwork: VISA
purchasesApr: 18.99
advancesApr: 24.99
transfersApr: 22.5
CLA/CLN -Loc account:
summary: CLA/CLN
value:
locAccount:
accountId: apPAcDP0EJZpFYM9cAJCe2k0DENEX4rjGOO
accountCategory: LOC_ACCOUNT
accountType: LINEOFCREDIT
accountNumber: '***************99999'
accountNumberDisplay: '***************99999'
status: OPEN
currency:
currencyCode: USD
balanceType: LIABILITY
contact:
holders:
- relationship: PRIMARY
interestRate: 2.74
balanceAsOf: '2022-03-17T00:00:00.000Z'
creditLine: 98000.0
availableCredit: 7355.35
nextPaymentAmount: 190.6
nextPaymentDate: '2022-03-18'
currentBalance: 90991.75
lastPaymentAmount: 250.0
lastPaymentDate: '2022-02-18'
lastStmtDate: '2022-02-21'
payOffAmount: 90991.75
maturityDate: '2026-04-13'
originalPrincipal: 98000.0
originatingDate: '2016-04-13'
interestPaidYearToDate: 422.65
purchasesApr: 18.99
advancesApr: 24.99
transfersApr: 22.5
CRL-locAccount:
summary: CRL
value:
locAccount:
accountId: PsBgRpTAT66ogdvy0wAa3qFZNpiDigawtQS
accountCategory: LOC_ACCOUNT
accountType: LINEOFCREDIT
accountNumber: '***************08888'
accountNumberDisplay: '***************08888'
status: OPEN
currency:
currencyCode: USD
balanceType: LIABILITY
contact:
holders:
- relationship: PRIMARY
interestRate: 0.18
lastActivityDate: '2022-03-15'
balanceAsOf: '2022-03-17T00:00:00.000Z'
creditLine: 1200.0
availableCredit: 1198.98
nextPaymentAmount: 0.0
currentBalance: 1.02
lastPaymentAmount: 0.0
lastStmtDate: '2022-02-22'
payOffAmount: 1.02
originalPrincipal: 1
# --- truncated at 32 KB (85 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/bbandt-corp/refs/heads/main/openapi/bbandt-corp-retail-accounts-openapi.yml