bankAccountIdstring(uuid)required
The unique identifier for the bank account
Example:550e8400-e29b-41d4-a716-446655440000
Update bank account
Updates an existing bank account scoped to the authenticated customer. Returns the updated record with the account number masked.
put
Path Parameters
Body
application/json
Body
application/json
UpdateBankAccountRequest
typestringrequired
The type of bank account
Allowed values:SAVINGSCHECKING
Example:CHECKING
holderNamestringrequired
Name of the account holder
Example:Jane Doe
numberstringrequired
Bank account number (4-17 digits)
Match pattern:^\d{4,17}$
>= 4 characters<= 17 characters
Example:9876543210
routingNumberstringrequired
Bank routing number (exactly 9 digits)
Match pattern:^\d{9}$
>= 9 characters<= 9 characters
Example:021000021
bankNamestringrequired
Name of the bank
Example:Wells Fargo
nicknamestring
Optional nickname for the bank account
Example:Secondary
primaryAccountboolean | null
Whether this should become the owner’s primary bank account. Setting true demotes any existing primary for the same owner. An existing primary account cannot be demoted directly by omitting or setting this to false — set another account as primary instead. null is treated the same as omitted.
Default:false
Example:false
Response
application/json
Response
application/json
Bank account updated successfully
BankAccountResponse
idstring(uuid)read-only
The unique identifier for the bank account
Example:550e8400-e29b-41d4-a716-446655440000
typestring
The type of bank account
Allowed values:SAVINGSCHECKING
Example:CHECKING
holderNamestring
Name of the account holder
Example:Jane Doe
numberstringread-only
Masked bank account number (last 4 digits visible)
Example:****7890
routingNumberstringread-only
Bank routing number
Example:021000021
bankNamestring
Name of the bank
Example:Chase Bank
nicknamestring
Optional nickname for the bank account
Example:Main
primaryAccountboolean
Indicates if this is the primary bank account
Example:true
createdAtstring(date-time)read-only
Timestamp when the bank account was created
Example:2024-01-15T10:30:00Z
updatedAtstring | null(date-time)read-only
Timestamp when the bank account was last updated
Example:2024-01-15T14:45:00Z
put/v2/bank-accounts/{bankAccountId}
Authentication
Path Parameters
Body
{
"type": "CHECKING",
"holderName": "Jane Doe",
"number": "9876543210",
"routingNumber": "021000021",
"bankName": "Wells Fargo"
}
application/json
List bank accounts for the authenticated customer
Returns every bank account (person-owned or firm-owned) visible to the authenticated customer, paginated by opaque continuation token. Use this endpoint to reconcile bank accounts across all producers in a customer’s account without iterating known producer IDs. Account numbers are masked to ****; the unmasked value is reachable only via GET /v2/bank-accounts/{id} behind an elevated scope.
get
Query Parameters
page_tokenstring
Opaque continuation token returned by the previous response’s page.nextToken. Omit on the first request. Format is server-controlled and may change without an API version bump.
page_sizeinteger(int32)
Requested number of items in the response. Defaults to 25 when omitted; values outside [1, 250] are rejected with 400 (not clamped). The actual size returned is reflected in page.size and may be smaller (last page or empty result).
Default:25
>= 1<= 250
updated_sincestring(date-time)
RFC3339 UTC timestamp (e.g. 2026-05-21T12:00:00Z). When supplied, filters to bank accounts whose underlying record was modified at or after this instant.
Example:2026-05-01T00:00:00Z
Response
application/json
Response
application/json
A page of bank accounts visible to the authenticated customer.
itemsarray[object]required
Per-row shape returned by V2 bank-account list endpoints. Carries owner context (personId or firmId, plus the producer NPN where known) for reconciliation use cases. The account number is always masked here; the unmasked value is reachable only via GET /v2/bank-accounts/{id} behind an elevated scope.
Show Child Parameters
pageobjectrequired
Page metadata for a token-based list response.
Show Child Parameters
get/v2/bank-accounts
Authentication
Query Parameters
application/json
List bank accounts for a person
Returns bank accounts belonging to the specified person and visible to the authenticated customer, paginated by opaque continuation token. Account numbers are masked to ****.
get
Query Parameters
page_tokenstring
Opaque continuation token returned by the previous response’s page.nextToken. Omit on the first request. Format is server-controlled and may change without an API version bump.
page_sizeinteger(int32)
Requested number of items in the response. Defaults to 25 when omitted; values outside [1, 250] are rejected with 400 (not clamped). The actual size returned is reflected in page.size and may be smaller (last page or empty result).
Default:25
>= 1<= 250
Path Parameters
personIdstring(uuid)required
ID of the person
Response
application/json
Response
application/json
A page of bank accounts belonging to the person.
itemsarray[object]required
Per-row shape returned by V2 bank-account list endpoints. Carries owner context (personId or firmId, plus the producer NPN where known) for reconciliation use cases. The account number is always masked here; the unmasked value is reachable only via GET /v2/bank-accounts/{id} behind an elevated scope.
Show Child Parameters
pageobjectrequired
Page metadata for a token-based list response.
Show Child Parameters
get/v2/persons/{personId}/bank-accounts
Authentication
Path Parameters
Query Parameters
application/json
Create bank account for person
Creates a new bank account for a person
post
Path Parameters
personIdstring(uuid)required
ID of the person
Body
application/json
Body
application/json
CreateBankAccountRequest
typestringrequired
The type of bank account
Allowed values:SAVINGSCHECKING
Example:CHECKING
holderNamestringrequired
Name of the account holder
Example:Jane Doe
numberstringrequired
Bank account number (4-17 characters)
>= 4 characters<= 17 characters
Example:1234567890
routingNumberstringrequired
Bank routing number (exactly 9 digits)
>= 9 characters<= 9 characters
Example:021000021
bankNamestringrequired
Name of the bank
Example:Chase Bank
nicknamestring
Optional nickname for the bank account
Example:Main
primaryAccountboolean | null
Whether this should become the owner’s primary bank account. Setting true demotes any existing primary for the same owner. Defaults to false (the owner’s first bank account always becomes primary regardless of this value). null is treated the same as omitted.
Default:false
Example:false
Response
application/json
Response
application/json
Bank account created successfully
BankAccountResponse
idstring(uuid)read-only
The unique identifier for the bank account
Example:550e8400-e29b-41d4-a716-446655440000
typestring
The type of bank account
Allowed values:SAVINGSCHECKING
Example:CHECKING
holderNamestring
Name of the account holder
Example:Jane Doe
numberstringread-only
Masked bank account number (last 4 digits visible)
Example:****7890
routingNumberstringread-only
Bank routing number
Example:021000021
bankNamestring
Name of the bank
Example:Chase Bank
nicknamestring
Optional nickname for the bank account
Example:Main
primaryAccountboolean
Indicates if this is the primary bank account
Example:true
createdAtstring(date-time)read-only
Timestamp when the bank account was created
Example:2024-01-15T10:30:00Z
updatedAtstring | null(date-time)read-only
Timestamp when the bank account was last updated
Example:2024-01-15T14:45:00Z
post/v2/persons/{personId}/bank-accounts
Authentication
Path Parameters
Body
{
"type": "CHECKING",
"holderName": "Jane Doe",
"number": "1234567890",
"routingNumber": "021000021",
"bankName": "Chase Bank"
}
application/json
List bank accounts for a firm
Returns bank accounts belonging to the specified firm and visible to the authenticated customer, paginated by opaque continuation token. Account numbers are masked to ****.
get
Query Parameters
page_tokenstring
Opaque continuation token returned by the previous response’s page.nextToken. Omit on the first request. Format is server-controlled and may change without an API version bump.
page_sizeinteger(int32)
Requested number of items in the response. Defaults to 25 when omitted; values outside [1, 250] are rejected with 400 (not clamped). The actual size returned is reflected in page.size and may be smaller (last page or empty result).
Default:25
>= 1<= 250
Path Parameters
firmIdstring(uuid)required
ID of the firm
Response
application/json
Response
application/json
A page of bank accounts belonging to the firm.
itemsarray[object]required
Per-row shape returned by V2 bank-account list endpoints. Carries owner context (personId or firmId, plus the producer NPN where known) for reconciliation use cases. The account number is always masked here; the unmasked value is reachable only via GET /v2/bank-accounts/{id} behind an elevated scope.
Show Child Parameters
pageobjectrequired
Page metadata for a token-based list response.
Show Child Parameters
get/v2/firms/{firmId}/bank-accounts
Authentication
Path Parameters
Query Parameters
application/json