How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Truist Personal and Small Business Accounts

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.

Truist Personal and Small Business Accounts is one of 15 APIs that BB&T Corp (Truist) publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Banking, Personal Banking, Open Banking, and Data. The published artifact set on APIs.io includes API documentation and an OpenAPI specification.

This API exposes 2 operations across 2 paths, and defines 40 schemas. It is described by OpenAPI 3.1.0, at version 2.6.0.

Requests are made against 3 base URLs: https://api-sandbox.truist.com/retail, https://apicert-secure.truist.com/retail, https://api-secure.truist.com/retail.

2 operations 2 paths 40 schemas 2 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
2.6.0
Base URL
https://api-secure.truist.com/retail
Authentication
OAuth 2.0
Resource Areas
1

Authentication & Security 1

Truist Personal and Small Business Accounts declares 1 security scheme for authenticating requests. It supports OAuth 2.0 (OAuth) using the authorizationCode flow, exposing 2 scopes. By default, every request must be authenticated.

  • OAuth — The production authorization URL will be provided after the onboarding process is completed.

Paths & Operations 2

Across 2 paths, the API surfaces 2 operations — 2 GET. Each is listed below with its method, path, parameters, and response codes.

Account Information 2

Search and view customer accounts

GET
/v2/accounts
Search for accounts
searchForAccounts 3 params → 200400401403404405409429
GET
/v2/accounts/{accountId}
Get an account
getAccount 3 params → 200401403404405409422429

Schemas 40

The contract defines 40 schemas that model the data the API accepts and returns. The most detailed are Holding (15 properties), AccountDescriptor (11 properties), InvestmentBalance (6 properties), TaxLot (6 properties). Each schema is shown below with its type and property counts.

Account
object
An abstract account entity that concrete account entities extend
AccountContact
object
Contact information for the account
1 property
AccountHolder
object
Defines the account holder's relationship with an account.
1 property
AccountHolderRelationship
string
Types of relationships between accounts and holders
AccountDescriptor
object
This descriptor provides minimal information about the account for use in lightweight arrays
11 properties
AccountWithDetails
object
This provides an instance of an account with full details
Accounts
object
An optionally paginated array of accounts
1 property
Currency
object
Represents an international currency
1 property
DebtSecurity
object
An investment in a debt security
DepositAccount
object
Information for a deposit account type
InvestmentAccount
object
An investment account type and information such as balances, transactions, holdings and privileges
Holding
object
A holding in an investment account
15 properties
InvestmentBalance
object
A point-in-time balance of the investment account
6 properties
LoanAccount
object
A loan account type
LocAccount
object
A line-of-credit account
Security
object
A base Security entity which defines the type of this security
1 property
TaxLot
object
Block of securities receiving the same tax treatment
6 properties
AccountBillPayStatus
string
Indicates bill pay capabilities for an account. ACTIVE: Can be used for bill payment AVAILABLE: Account can be requested for bill payment NOTAVAILABLE: Account…
AccountCategory
string
The category of account
AccountStatus
string
The status of an account
BalanceType
string
Type of balance 'ASSET': Positive transaction amount increases balance 'LIABILITY': Positive transaction amount decreases balance
CompoundingPeriod
string
Interest compounding Period
DebtClass
string
The classification of a debt instrument
DebtType
string
The type of a debt instrument
HoldingType
string
The type of an investment holding | Value | Description | |-----|-----| | ANNUITY | Financial product that pays out a fixed stream of payments | | BOND | Debt…
InvestmentBalanceType
string
The type of an investment balance
PaymentFrequency
string
The frequency of payments.
PositionType
string
The type of an investment position
SecurityCategory
string
The type of security
Error
object
An error entity which can be used at the API level for error responses
2 properties
ActorType
string
Indicates whether a customer is present and has requested the operation (USER), or if a batch job has requested the operation (BATCH)
AccountType
string
The type of an account. | Value | Description | |-----|-----| | BROKERAGEPRODUCT | Investment management offered by a licensed brokerage firm that places trade…
DateString
string
ISO 8601 full-date in format 'YYYY-MM-DD' according to [IETF RFC 3339](https://datatracker.ietf.org/doc/html/rfc3339.htmlsection-5.6)
BusinessOrConsumer
string
Indicator if parent entity is a consumer or business
FapiInteractionId
string
Universally unique identifier for this interaction, used across all FDX API requests and responses
FiAttribute
object
Financial Institution provider-specific attribute
2 properties
Identifier
string
Value for a unique identifier
Iso4217Code
string
Currency, fund and precious metal codes effective from May 12, 2025 and ISO 4217 amendment 179 per [ISO 4217 Currency Code Maintenance](https://www.six-group.c…
ResultType
string
Flag to indicate if you want a lightweight array of metadata (AccountDescriptor or Tax or Operations) or full item details (Account or a Tax subclass or Availa…
Timestamp
string
ISO 8601 date-time in format 'YYYY-MM-DDThh:mm:ss.nnn[Z|[+|-]hh:mm]' according to [IETF RFC 3339](https://datatracker.ietf.org/doc/html/rfc3339.htmlsection-5.6)

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

bbandt-corp-retail-accounts-openapi.yml Raw ↑

Other APIs BB&T Corp (Truist) publishes across the network.

Truist Commercial Accounts
Truist Commercial Account Balance
Truist Commercial Account Transactions
Truist Branch/ATM Locator
Truist Personal and Small Business Transactions
Truist Personal and Small Business Client Contact
Truist Retail Oauth Authentication
Truist User Consent
Truist Retail Dynamic Client Registration
Truist Personal and Small Business Account Payment Networks
Truist Account Address
Truist Credit Transfers
Where this information came from

This is an independent, third-party profile of Truist Personal and Small Business Accounts, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.