Vermecilli - Release/26.04

Published On: 12 June 2026
Stage Deployment On: 15 June 2026
Production Go-Live On: The release date will be communicated by the account manager.

This release includes updates to Customer Address APIs, Client Non-Person Details, and Identifier APIs. Changes include new v2 customer address endpoints, removal of deprecated fields from clientNonPersonDetails, and support for the IssuedCountry parameter for I-20 document identifiers.

Release Notes

Customer Address APIs v2

New v2 APIs are available to add and update customer addresses.

Add Customer Address v2

Use this API to add an address for an existing customer.

Endpoint

POST /api/v2/client/{clientId}/addresses

Example request

curl --request POST \
     --url https://api.cloud.mbanq.com/api/v2/client/123/addresses \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --header 'tenantId: z01j3e71zd6zkq908vyf5861a8' \
     --data '
{
  "addressTypeId": 31,
  "addressLine1": "456 Oak Avenue",
  "city": "San Francisco",
  "stateProvinceId": 546,
  "stateISOCode": "CA",
  "countryId": 284,
  "countryISOCode": "US",
  "postalCode": 94103,
  "isActive": true
}
'

Update Customer Address v2

Use this API to update an existing customer address.

Endpoint

PUT /api/v2/client/{clientId}/addresses/{addressId}

Example request

curl --request PUT \
     --url https://api.cloud.mbanq.com/api/v2/client/11/addresses/11 \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --header 'tenantId: z01j3e71zd6zkq908vyf5861a8' \
     --data '
{
  "addressLine1": "12 East Santa Clara Street",
  "addressLine2": "Building B",
  "addressLine3": "Downtown San Jose",
  "city": "San Jose",
  "town": "Willow Glen",
  "stateProvinceId": 546,
  "countryId": 284,
  "stateISOCode": "LA",
  "countryISOCode": "US",
  "postalCode": "95113"
}
'

Note: The countryISOCode field should be sent as countryISOCode. Do not include an escaped quote in the field name.

Client Non-Person Details

The following fields have been removed from clientNonPersonDetails:

• locale
• dateFormat

Clients should stop sending these fields in the clientNonPersonDetails payload.

Identifier API

The Identifier API now supports the IssuedCountry parameter for I-20 document identifiers.

This update applies to:

• GET Identifier API
• POST Identifier API

Use IssuedCountry when creating or retrieving identifier records for I-20 documents where the issuing country must be captured.

Dependent Account

Introduced the new dependent-account feature for retail parent-controlled savings accounts.

This feature exposes APIs that allow a primary savings account holder to create and manage dependent accounts, including allocating and deallocating funds.

This update includes the following APIs:

• POST /v1/savingsaccounts/{primaryAccountId}/dependentaccounts
• GET /v1/savingsaccounts/{primaryAccountId}/dependentaccounts
• POST /v1/savingsaccounts/{primaryAccountId}/dependentaccounts/{dependentAccountId}/fund?command=allocate|deallocate

Impacted APIs