POST/v2/application/business/update

Update Business Plus Application

Fills in or edits the Business Plus form for an application you have already created. Send the application id. Call this again whenever the details change.

Headers

FieldTypeRequiredPossible valuesDescription
session-tokenstringRequired—

SessionToken obtained from the Create GMA Session endpoint. All secured endpoints require this header.

Request body

FieldTypeRequiredPossible valuesDescription
BusinessobjectRequired—

Version 2 Business Plus form. Send the whole form on every submit. Include the application id from Create Business Plus Application. PrimaryIndividual is required when you first complete the form.

Business.IdstringRequired—

Application id returned by Create Business Plus Application. Required on every update.

Business.TypeintegerRequired1

Business Plus application type. Supports only `1`.

Business.BusinessNamestringRequired—

Legal business name. Min: 2, Max: 100 characters.

Business.EntityTypestring (enum)RequiredSole_Proprietorship | Partnership | Limited_Partnership | Limited_Liability_Partnership | Corporation | S_Corporation | Limited_Liability_Company | Cooperative | Non_Profit_Organisation | Benefit_Corporation | Trust

Legal entity type.

Business.BusinessRegistrationCountrystringRequired—

Country of business registration. ISO Alpha-2 code (e.g. `US`).

Business.BusinessRegistrationNumberstringRequired—

Business registration number. Min: 2, Max: 50 characters.

Business.BusinessFormationDatestringRequired—

Business registration date. Format: `yyyyMMdd` (e.g. `20250404`).

Business.BusinessIndustryTypestring (enum)Requiredagriculture | mining | utilities | construction | manufacturing | wholesale | retail | transportation | information | finance | real | professional | management | administrative | educational | health | arts | accommodation | other | public

NAICS industry category.

Business.IsFinancialInstitutionbooleanRequired—

Whether the business is a financial institution.

Business.CountriesOfOperationsarray<string>Required—

ISO country codes where the business operates.

Business.InOperationbooleanRequired—

Has the business started operations? When `true`, `OperationStartDate` is required. When `false`, `OperateEstDate` is required.

Business.WebsitebooleanRequired—

Indicates whether the business has a website.

Business.BusSourceOfFundsarray<string> (enum)Requiredrevenue_from_business_operations | loans_and_financing | investment_income | capital_contribution | government_grants_and_subsidies | intercompany_transfers | sales_of_assets | customer_payments | royalties_from_intellectual_property | licensing_fees | franchise_fees | litigation_proceeds | contracts | commissions | rental_income | inheritance | insurance_income | lifetime_savings_of_owners | lottery_and_gaming | retained_earnings | retirement_account

Business source of funds.

Business.BusPurposeOfAccountstringRequired—

Purpose of the account. Example: operational.

Business.PrimaryBusinessActivitiesstringRequired—

Primary business activities description.

Business.IllegalImmoralDisclosurearray<string> (enum)Requiredmarjuana_or_cannabis | gambling | cash_transactions | guns_arms_or_ammunition | adult_content_or_pornography | precious_metals | none_of_the_above

Disclosure of involvement in illegal or immoral activities. Use `none_of_the_above` if none apply.

Business.DepositLocationsarray<string> (enum)Requiredusa | canada | europe | asia | china | south_america | central_america | caribbean | africa | australia_nz | middle_east

Geographic regions from which deposits are expected.

Business.PaymentLocationsarray<string> (enum)Requiredusa | canada | europe | asia | china | south_america | central_america | caribbean | africa | australia_nz | middle_east

Geographic regions to which payments are expected.

Business.ExpectedDepositVolumeTierstring (enum)Requiredlow | medium | other

Expected monthly deposit volume tier. When the value is other, send ExpectedDepositVolumeTierOther and omit it otherwise.

Business.ExpectedPaymentVolumeTierstring (enum)Requiredlow | medium | other

Expected monthly payment volume tier. When the value is other, send ExpectedPaymentVolumeTierOther and omit it otherwise.

Business.CustomersInSanctionedCountriesbooleanRequired—

Whether the business has customers in sanctioned countries.

Business.HasEntitybooleanRequired—

Indicates whether the business has related entities.

Business.AddressobjectRequired—

Primary registered business address.

Business.Address.StreetstringRequired—

Street name. Max 40 characters.

Business.Address.BuildingNumberstringRequired—

Building or suite number. Max 40 characters.

Business.Address.CitystringRequired—

City. Min 2, Max 40 characters.

Business.Address.StatestringRequired—

State or province. Min 2, Max 40 characters.

Business.Address.PinCodestringRequired—

Postal / ZIP code

Business.Address.CountrystringRequirede.g. US | GB | DE

Country code. ISO 3166-1 alpha-2 (e.g. `US`, `GB`).

Business.AddressList[].Typestring (enum)RequiredMAILING | REGISTERED

Address category.

Business.AddressList[].StreetstringRequired—

Street name. Max 40 characters.

Business.AddressList[].BuildingNumberstringRequired—

Building or suite number. Max 40 characters.

Business.AddressList[].CitystringRequired—

City. Min 2, Max 40 characters.

Business.AddressList[].StatestringRequired—

State or province. Min 2, Max 40 characters.

Business.AddressList[].PinCodestringRequired—

Postal / ZIP code

Business.AddressList[].CountrystringRequirede.g. US | GB | DE

Country code. ISO 3166-1 alpha-2 (e.g. `US`, `GB`).

Business.MobileCountryCodeintegerRequired—

International dialing code for MobilePhone (e.g. `1` for US).

Business.MobilePhonestringRequired—

Business mobile phone number.

Business.SignerFirstNamestringRequired—

Authorized signer's first name. Min: 2, Max: 50 characters. Not collected by the broker onboarding flow; provide programmatically.

Business.SignerLastNamestringRequired—

Authorized signer's last name. Min: 2, Max: 50 characters. Not collected by the broker onboarding flow; provide programmatically.

Business.TncbooleanRequired—

Certificate of Beneficial Owners agreement acceptance. Not collected by the broker onboarding flow; provide programmatically.

Business.AcceptDelarationAggrementbooleanRequired—

Terms and Conditions acceptance. Not collected by the broker onboarding flow; provide programmatically.

Business.SignaturestringRequired—

Applicant's signature. Not collected by the broker onboarding flow; provide programmatically.

PrimaryIndividualobjectRequired—

Primary representative for the application. Required on create; omit on re-submit. Should include the full `BrokerIndividual` payload — see `Create Officer` for all available fields. At minimum include `FirstName`, `LastName`, `Email`, `MobileCountryCode`, `MobilePhone`, and `IsPrimaryUser: true`.

PrimaryIndividual.IdstringRequired—

Id of the primary individual. Required on update.

PrimaryIndividual.FirstNamestringRequired—

First name.

PrimaryIndividual.LastNamestringRequired—

Last name.

PrimaryIndividual.EmailstringRequired—

Email address. Must be unique.

PrimaryIndividual.MobileCountryCodeintegerRequired—

International dialing code for MobilePhone.

PrimaryIndividual.MobilePhonestringRequired—

Mobile phone number.

PrimaryIndividual.IsPrimaryUserbooleanRequired—

Set to `true` for the primary representative.

PrimaryIndividual.IsShareHolderbooleanRequired—

Is this person a shareholder?

PrimaryIndividual.IsAuthorizedUserbooleanRequired—

Is this person an authorized user?

PrimaryIndividual.AddressobjectRequired—

Residential address. Required for shareholders, authorized users, directors, and control persons.

PrimaryIndividual.Address.StreetstringRequired—

Street name

PrimaryIndividual.Address.BuildingNumberstringRequired—

Building or house number

PrimaryIndividual.Address.CitystringRequired—

City name

PrimaryIndividual.Address.StatestringRequired—

State or province name

PrimaryIndividual.Address.PinCodestringRequired—

Postal or ZIP code

PrimaryIndividual.Address.CountrystringRequired—

ISO Alpha-2 country code (e.g. `US`)

Business.DoingBusinessAsstringOptional—

DBA (Doing Business As) name. Min: 1, Max: 100 characters.

Business.BusinessRegistrationStatestringOptional—

State or region of business registration.

Business.EinstringOptional—

Employer Identification Number. Min: 5, Max: 20 characters. Required when `BusinessRegistrationCountry` is `US`.

Business.BusinessTaxIdstringOptional—

Business Tax ID. Min: 2, Max: 20 characters. Required when `BusinessRegistrationCountry` is not `US`.

Business.UrlstringOptional—

Business website URL. Required when `Website` is `true`. Min: 5, Max: 500 characters.

Business.BusSourceOfWealtharray<string> (enum)Optionalemployment_compensation | proceeds_from_sale | gifts_from_family | family_loan | casino_lottery_winnings | retirement_pension | inheritance | bank_loan | income_legal_settlements | investments

Sources of business wealth.

Business.CustomerDescriptionstringOptional—

Description of the business's customer base.

Business.AnnualRevenuestringOptional—

Annual revenue tier. Example: tier2.

Business.ExpectedDepositVolumeTierOtherstringOptional—

Free text required when ExpectedDepositVolumeTier is other. Omit otherwise.

Business.ExpectedPaymentVolumeTierOtherstringOptional—

Free text required when ExpectedPaymentVolumeTier is other. Omit otherwise.

Business.HasSanctionedCountryExposurebooleanOptional—

Whether the business has sanctioned-country exposure.

Business.Entitiesarray<object>Optional—

List of related entities (subsidiaries, affiliates, shareholders). Required when `HasEntity` is `true`.

Business.Entities[].Relationsstring (enum)Optionalsubsidiary | affiliate | shareholder

Relationship of this entity to the business. Required when `HasEntity` is `true`.

Business.Entities[].NamestringOptional—

Legal name of the related entity. Required when `HasEntity` is `true`.

Business.Entities[].IncorpCountrystringOptional—

Country of incorporation (ISO alpha-2). Required when `HasEntity` is `true`.

Business.Entities[].WebsitestringOptional—

Website URL of the related entity. Optional.

Business.Entities[].BusinessNaturestringOptional—

Description of the related entity's business nature. Required when `HasEntity` is `true`.

Business.Entities[].YearOfIncorporationstringOptional—

Year the related entity was incorporated (e.g. `2020`). Required when `HasEntity` is `true`.

Business.Entities[].PercentOwnernumberOptional—

Ownership percentage held by the business. Required when `Entities[].Relations` is `shareholder`.

Business.Entities[].SourceOfWealthListarray<string> (enum)Optionalemployment_compensation | retirement_pension | proceeds_from_sale | inheritance | gifts_from_family | bank_loan | family_loan | income_legal_settlements | casino_lottery_winnings | investments

Source of wealth for the shareholder entity. Required when `Entities[].Relations` is `shareholder`.

Business.AddressListarray<object>Optional—

Additional business addresses (e.g. registered address, mailing address). Each entry requires at minimum `Type`, `Street`, `BuildingNumber`, `City`, `State`, and `Country`.

Business.LandlineCountryCodeintegerOptional—

International dialing code for LandlinePhone.

Business.LandlinePhonestringOptional—

Business landline phone number.

Business.SignerMiddleNamestringOptional—

Authorized signer's middle name. Max: 50 characters.

PrimaryIndividual.MiddleNamestringOptional—

Middle name. Max 50 characters.

PrimaryIndividual.MotherMaidenNamestringOptional—

Mother's maiden name. Required when `IsAuthorizedUser` is `true`.

PrimaryIndividual.DobstringOptional—

Date of birth. Format: `yyyyMMdd`. Required for shareholders, authorized users, directors, and control persons.

PrimaryIndividual.NationalitystringOptional—

ISO 3166-1 alpha-2 nationality. Required for shareholders, authorized users, directors, and control persons.

PrimaryIndividual.TaxIdstringOptional—

Tax ID number. Required for shareholders, authorized users, directors, and control persons.

PrimaryIndividual.SsnstringOptional—

Social Security Number (9 digits, no hyphens). Required for US individuals.

PrimaryIndividual.Rolestring (enum)Optionalceo | cfo | coo | president | vice_president | partner | manager | other

Role. Required when `IsAuthorizedUser` is `true`.

PrimaryIndividual.AccessTypestring (enum)OptionalStdViewer | StdBasic | StdApprover | NoGroup

Account access level. Required when `IsAuthorizedUser` is `true`.

PrimaryIndividual.CardnumberOptionale.g. 1

Card preference flag (e.g. `1`). Used with address country for Visa debit card eligibility.

PrimaryIndividual.MailingAddressobjectOptional—

Mailing address. Same shape as `PrimaryIndividual.Address`.

PrimaryIndividual.MailingAddress.StreetstringOptional—

Street name

PrimaryIndividual.MailingAddress.BuildingNumberstringOptional—

Building or house number

PrimaryIndividual.MailingAddress.CitystringOptional—

City name

PrimaryIndividual.MailingAddress.StatestringOptional—

State or province name

PrimaryIndividual.MailingAddress.PinCodestringOptional—

Postal or ZIP code

PrimaryIndividual.MailingAddress.CountrystringOptional—

ISO Alpha-2 country code (e.g. `US`)

PrimaryIndividual.IsControlPersonbooleanOptional—

Is this person a control person of the business?

PrimaryIndividual.IsIndependentDirectorbooleanOptional—

Is this person an independent director? Required when `IsShareHolder`, `IsAuthorizedUser`, and `IsControlPerson` are all `false`.

PrimaryIndividual.IsDirectorbooleanOptional—

Is this person a director? Required when `IsShareHolder`, `IsAuthorizedUser`, or `IsControlPerson` is `true`.

PrimaryIndividual.IsAuthorizedContactbooleanOptional—

Is this person an authorized contact? Required when `IsAuthorizedUser` is `true`.

PrimaryIndividual.IsAgentWithAttorneyPowerbooleanOptional—

Does this person hold power of attorney? Required when `IsAuthorizedUser` is `true`.

PrimaryIndividual.HaveControlOverEntitybooleanOptional—

Does this person have control over a related entity?

PrimaryIndividual.PercentOwnernumberOptional—

Ownership percentage held by this individual (e.g. `25`).

PrimaryIndividual.SourceOfWealthListarray<string> (enum)Optionalemployment_compensation | retirement_pension | proceeds_from_sale | inheritance | gifts_from_family | bank_loan | family_loan | income_legal_settlements | casino_lottery_winnings | investments

Sources of wealth for this individual.

PrimaryIndividual.CountryOfIssuancestringOptionale.g. US | GB | DE

Country that issued the individual's primary ID document. ISO 3166-1 alpha-2. Required when IsShareHolder, IsAuthorizedUser, IsIndependentDirector, or IsControlPerson is `true`.

Example request

{
  "Business": {
    "Id": "6a3a2f324c2e4b093dce834b",
    "Type": 1,
    "EntityType": "Limited_Liability_Company",
    "SignerFirstName": "Ada",
    "SignerMiddleName": "Mary",
    "SignerLastName": "Lovelace",
    "Tnc": true,
    "AcceptDelarationAggrement": true,
    "Signature": "Ada Lovelace",
    "PrimaryBusinessActivities": "Wholesale distribution of consumer electronics to retail partners across the United States.",
    "CustomerDescription": "Mid-size retail chains and independent electronics stores in the United States.",
    "BusSourceOfFunds": [
      "revenue_from_business_operations"
    ],
    "IllegalImmoralDisclosure": [
      "none_of_the_above"
    ],
    "DepositLocations": [
      "usa"
    ],
    "PaymentLocations": [
      "usa"
    ],
    "HasEntity": true,
    "MobileCountryCode": 1,
    "LandlineCountryCode": 1,
    "MobilePhone": "2025550125",
    "LandlinePhone": "2025550127",
    "Website": true,
    "Url": "https://www.example.com",
    "BusinessName": "Example Holdings LLC",
    "DoingBusinessAs": "Example Holdings",
    "BusinessRegistrationCountry": "US",
    "BusinessTaxId": "12-3456789",
    "Ein": "123456789",
    "BusinessRegistrationNumber": "12345678",
    "BusinessFormationDate": "20200101",
    "InOperation": true,
    "BusinessIndustryType": "wholesale",
    "Address": {
      "Street": "Example Street",
      "BuildingNumber": "221B",
      "City": "New York",
      "State": "NY",
      "PinCode": "10001",
      "Country": "US"
    },
    "AddressList": [
      {
        "Street": "Example Street",
        "BuildingNumber": "221B",
        "City": "New York",
        "State": "NY",
        "PinCode": "10001",
        "Country": "US",
        "Type": "MAILING"
      },
      {
        "Street": "Example Street",
        "BuildingNumber": "221B",
        "City": "New York",
        "State": "NY",
        "PinCode": "10001",
        "Country": "US",
        "Type": "REGISTERED"
      }
    ],
    "Entities": [
      {
        "Relations": "subsidiary",
        "Name": "Example Subsidiary Ltd",
        "IncorpCountry": "US",
        "Website": "https://sub.example.com",
        "BusinessNature": "Wholesale distribution",
        "YearOfIncorporation": 2020,
        "PercentOwner": 100,
        "SourceOfWealthList": [
          "employment_compensation"
        ]
      }
    ],
    "BusinessRegistrationState": "NY",
    "IsFinancialInstitution": false,
    "CountriesOfOperations": [
      "US"
    ],
    "BusSourceOfWealth": [
      "employment_compensation"
    ],
    "BusPurposeOfAccount": "operational",
    "AnnualRevenue": "tier2",
    "ExpectedDepositVolumeTier": "low",
    "ExpectedPaymentVolumeTier": "low",
    "CustomersInSanctionedCountries": false,
    "HasSanctionedCountryExposure": false
  },
  "PrimaryIndividual": {
    "Id": "6a3a2f324c2e4b093dce834c",
    "FirstName": "Ada",
    "MiddleName": "Mary",
    "LastName": "Lovelace",
    "MotherMaidenName": "Byron",
    "Dob": "19900131",
    "Nationality": "US",
    "Email": "ada1@example.com",
    "MobileCountryCode": 1,
    "MobilePhone": "2025550128",
    "TaxId": "TIN12345678",
    "Ssn": "123456789",
    "CountryOfIssuance": "US",
    "IsPrimaryUser": true,
    "IsShareHolder": true,
    "PercentOwner": 30,
    "IsAuthorizedUser": true,
    "Role": "ceo",
    "AccessType": "StdViewer",
    "IsAuthorizedContact": true,
    "IsAgentWithAttorneyPower": false,
    "IsDirector": true,
    "IsIndependentDirector": false,
    "IsControlPerson": true,
    "HaveControlOverEntity": true,
    "SourceOfWealthList": [
      "employment_compensation"
    ],
    "Address": {
      "Street": "Example Street",
      "BuildingNumber": "221B",
      "City": "New York",
      "State": "NY",
      "PinCode": "10001",
      "Country": "US"
    },
    "Card": 1,
    "MailingAddress": {
      "Street": "Example Street",
      "BuildingNumber": "221B",
      "City": "New York",
      "State": "NY",
      "PinCode": "10001",
      "Country": "US"
    }
  }
}

Response

FieldTypePossible valuesDescription
ResponseCodeinteger200 | 201 | 204 | 301 | 400 | 401 | 403 | 404 | 410 | 422 | 500 | 503

API result code in the response envelope. Indicates success or the error category (e.g. 200 success, 400 bad request, 401 unauthorized).

ResponseMessagestringSuccess | Created | NoContent | BadRequest | Unauthorized | Forbidden | NotFound | Gone | UnprocessableContent | ServerError | ResourceMoved | ServiceUnAvailable | UnProcessableEntity

Human-readable label paired with ResponseCode (e.g. Success, BadRequest, Unauthorized). Use with ResponseCode to interpret the outcome.

ResponseDataobjectPlease refer to below example for response body

The saved Business Plus record. Use `ApplicationId` on later calls.

Example response

{
  "ResponseCode": 200,
  "ResponseMessage": "Success",
  "ResponseData": {
    "Version": 0,
    "Id": "6a585058e557d865e30a8d4f",
    "Type": 1,
    "EntityType": "Limited_Liability_Company",
    "SignerFirstName": "Ada",
    "SignerMiddleName": "Mary",
    "SignerLastName": "Lovelace",
    "Tnc": true,
    "AcceptDelarationAggrement": true,
    "Signature": "Ada Lovelace",
    "PrimaryBusinessActivities": "Wholesale distribution of consumer electronics to retail partners across the United States.",
    "CustomerDescription": "Mid-size retail chains and independent electronics stores in the United States.",
    "BusSourceOfFunds": [
      "revenue_from_business_operations"
    ],
    "IllegalImmoralDisclosure": [
      "none_of_the_above"
    ],
    "DepositLocations": [
      "usa"
    ],
    "PaymentLocations": [
      "usa"
    ],
    "HasEntity": true,
    "Entities": [
      {
        "Relations": "subsidiary",
        "Name": "Example Subsidiary Ltd",
        "Website": "https://sub.example.com",
        "IncorpCountry": "US",
        "SourceOfWealthList": [
          "employment_compensation"
        ],
        "YearOfIncorporation": 2020,
        "BusinessNature": "Wholesale distribution",
        "PercentOwner": 100
      }
    ],
    "MobileCountryCode": 1,
    "LandlineCountryCode": 1,
    "MobilePhone": "2025550125",
    "LandlinePhone": "2025550127",
    "Website": true,
    "Url": "https://www.example.com",
    "BusinessName": "Example Holdings LLC",
    "DoingBusinessAs": "Example Holdings",
    "AddressList": [
      {
        "City": "New York",
        "State": "NY",
        "Country": "US",
        "PinCode": "10001",
        "Street": "Example Street",
        "BuildingNumber": "221B",
        "Type": "MAILING"
      },
      {
        "City": "New York",
        "State": "NY",
        "Country": "US",
        "PinCode": "10001",
        "Street": "Example Street",
        "BuildingNumber": "221B",
        "Type": "REGISTERED"
      }
    ],
    "Address": {
      "City": "New York",
      "State": "NY",
      "Country": "US",
      "PinCode": "10001",
      "Street": "Example Street",
      "BuildingNumber": "221B"
    },
    "BusinessRegistrationCountry": "US",
    "BusinessTaxId": "12-3456789",
    "Ein": "123456789",
    "BusinessRegistrationNumber": "12345678",
    "BusinessFormationDate": "20200101",
    "InOperation": true,
    "BusinessIndustryType": "wholesale",
    "BusinessRegistrationState": "NY",
    "IsFinancialInstitution": false,
    "CountriesOfOperations": [
      "US"
    ],
    "BusSourceOfWealth": [
      "retained_earnings"
    ],
    "BusPurposeOfAccount": "operational",
    "AnnualRevenue": "tier2",
    "ExpectedDepositVolumeTier": "low",
    "ExpectedPaymentVolumeTier": "low",
    "CustomersInSanctionedCountries": false,
    "HasSanctionedCountryExposure": false
  }
}

On create, `Version` will be 0. On re-submit, `Version` increments. Use `ApplicationId` from the response as the `id` path param for `Get Business Plus Application` and as `ApplicationId` in subsequent individual/document operations.

A 400 with `invalid_param` is returned if the email is already in use.

ℹ  Note

A 423 Application Locked response is returned when the application is in a locked or final status. No further modifications are permitted until FV Bank unlocks the application.

ℹ  Note

On 400 validation errors, each error in ResponseErrors includes a Field property that identifies the failing PascalCase request body field (e.g. Business.Phone, Email, Address.City). Use this to surface precise field-level error messages in your UI.

Requires `session-token: {SessionToken}` from Create GMA Session. Use the same client IP as authentication.

Search guide books, endpoints, paths, or parameters

↑↓navigate↵openEscclose