POST/application/submit-form

Create Application

Creates a new broker-managed Business Plus application.

Business.Id must be absent. PrimaryIndividual is required and must include at least the primary representative's details. The API validates business fields against the configured KYB schema.

The response returns the full saved Business object. Save the ApplicationId from the response — it is required for all subsequent calls (submit-individual, document/upload, ask/answer, GET detail, etc.).

KYC checks, sanctions screening, and officer-track reconciliation run asynchronously after the synchronous save.

Headers

FieldTypeRequiredPossible valuesDescription
session-tokenstringRequired

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

Request body

FieldTypeRequiredPossible valuesDescription
BusinessobjectRequired

Full business KYB payload. Must NOT include Business.Id on first create.

Business.TypeintegerRequired1

Business Plus application type. Supports only `1`.

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.AmountOfInitialDepositintegerRequired

Expected initial deposit amount (USD)

Business.AverageBalanceintegerRequired

Expected average account balance (USD)

Business.NumberOfMonthlyAchDepositsintegerRequired

Expected monthly ACH deposit count

Business.AmountOfMonthlyAchDepositsintegerRequired

Expected monthly ACH deposit amount (USD)

Business.NumberOfMonthlyDomesticWireDepositsnumberRequired

Expected monthly domestic wire deposit count

Business.AmountOfMonthlyDomesticWireDepositsnumberRequired

Expected monthly domestic wire deposit amount (USD)

Business.NumberOfMonthlyInternationalWireDepositsnumberRequired

Expected monthly international wire deposit count

Business.AmountOfMonthlyInternationalWireDepositsnumberRequired

Expected monthly international wire deposit amount (USD)

Business.NumberOfMonthlyAchPaymentsnumberRequired

Expected monthly ACH payment count

Business.AmountOfMonthlyAchPaymentsnumberRequired

Expected monthly ACH payment amount (USD)

Business.NumberOfMonthlyDomesticWirePaymentsnumberRequired

Expected monthly domestic wire payment count

Business.AmountOfMonthlyDomesticWirePaymentsnumberRequired

Expected monthly domestic wire payment amount (USD)

Business.NumberOfMonthlyInternationalWirePaymentsnumberRequired

Expected monthly international wire payment count

Business.AmountOfMonthlyInternationalWirePaymentsnumberRequired

Expected monthly international wire payment amount (USD)

Business.ExpectedAmountMonthlyDigitalCurrencyCustodynumberRequired

Expected monthly digital currency custody amount (USD)

Business.HasBusinessPlanbooleanRequired

Indicates whether the business has a written business plan.

Business.Businessesarray<string> (enum)RequiredMSB_Crypto_Exchange_OTC_Liquidity_Provider_Remittance_FX_Business | Stock_Brokerage | Fund_Family_Office | Financial_Institution | Other

Business categories.

Business.MoneyServicesBusinessbooleanRequired

Indicates whether the business is a money services business.

Business.MerchantAcquirerPspbooleanRequired

Indicates whether the business operates as a merchant acquirer or payment service provider.

Business.MobileCountryCodeintegerRequired

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

Business.MobilePhonestringRequired

Business mobile phone number.

Business.WebsitebooleanRequired

Indicates whether the business has a website.

Business.PrimaryBusinessActivitiesstringRequired

Primary business activities description.

Business.BusinessProductServicesstringRequired

Description of products and services. Max: 1024 characters.

Business.CustomerDescriptionstringRequired

Description of the business's customer base.

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.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.DepositReasonsarray<string> (enum)Requiredreceiving_funds_against_invoices_from_customer | receiving_funds_from_investors | receiving_own_funds_from_other_accounts | receiving_funds_from_the_liquidation

Reasons for expected deposits.

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.PaymentReasonsarray<string> (enum)Requiredtrade_supplier_expense | credit_card_and_loan_payments | salaries_or_commissions | travel | own_investments_equity_debt_token | capital_expenditures | legal_and_accounting | tax_payments | utilities | technology_and_it | mortgage_and_leases

Reasons for expected payments.

Business.HasEntitybooleanRequired

Indicates whether the business has related entities.

Business.PenaltybooleanRequired

Indicates whether the business has had any regulatory penalties.

Business.LitigationbooleanRequired

Indicates whether the business is involved in litigation.

Business.LiquidFundsbooleanRequired

Indicates whether the business has liquid funds.

Business.BankAccountAnotherFinancialInstitutionbooleanRequired

Indicates whether the business holds accounts at other financial institutions.

Business.EmpCountstring (enum)Required1_10 | 11_25 | 26_50 | 50+

Employee count category.

Business.BusinessNamestringRequired

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

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.AddressListarray<object>Required

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

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.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.InOperationbooleanRequired

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

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.InternationalCustomersarray<string> (enum)RequiredAfghanistan | Belarus | Bosnia_and_Herzegovina | Burma | Central_African_Republic | Congo | Croatia | Cuba | Ethiopia | Iran | Iraq | Kosovo | Lebanon | Libya | Macedonia_North | Mali | Montenegro | Nicaragua | North_Korea | Russian_Federation | Serbia | Slovenia | Somalia | South_Sudan | Sudan | Syria | Ukraine | Venezuela | Yemen | Zimbabwe | None_of_the_above

List of high-risk countries from which the business accepts customers. Use `None_of_the_above` if none apply.

Business.HasCoinConversionPlanbooleanRequired

Plans to convert stablecoins to/from fiat.

Business.HasCryptoConversionPlanbooleanRequired

Plans to convert cryptocurrencies to/from fiat.

Business.DealsInCryptocurrencybooleanRequired

Indicates whether the business deals in cryptocurrency.

PrimaryIndividualobjectRequired

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

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.CreatedAtinteger (int64)Optional

Unix timestamp in seconds when the record was created. Server-assigned; do not include in request.

Business.UpdatedAtinteger (int64)Optional

Unix timestamp in seconds when the record was last updated. Server-assigned; do not include in request.

Business.BusinessOtherstringOptionalAny string

Specify other business type when Other is selected in Businesses. Min: 2, Max: 50 characters.

Business.SignerFirstNamestringOptional

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

Business.SignerMiddleNamestringOptional

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

Business.SignerLastNamestringOptional

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

Business.TncbooleanOptional

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

Business.AcceptDelarationAggrementbooleanOptional

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

Business.SignaturestringOptional

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

Business.RegulatedDisclosurebooleanOptional

Indicates whether the business is regulated.

Business.RegulatoryAgencyarray<string> (enum)OptionalOFAC | FinCEN | OCC | Fed_Reserve | OTS | FDIC | SEC | IRS | Other

Applicable regulatory agencies. Required when `RegulatedDisclosure` is `true`.

Business.PrimaryBusinessModelstringOptional

Description of the primary business model. Required when `MoneyServicesBusiness` is `true`.

Business.PhonestringOptional

Business phone number. Min: 10, Max: 15 characters.

Business.LandlineCountryCodeintegerOptional

International dialing code for LandlinePhone.

Business.LandlinePhonestringOptional

Business landline phone number.

Business.UrlstringOptional

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

Business.EngagestringOptional

Description of how the business engages customers without a website. Required when `Website` is `false`.

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.PenaltyDetailsstringOptional

Details of regulatory penalties. Required when `Penalty` is `true`.

Business.LitigationDetailsstringOptional

Details of ongoing or past litigation. Required when `Litigation` is `true`.

Business.AdditionalBankAccountInstNamestringOptional

Name of the other financial institution. Required when `BankAccountAnotherFinancialInstitution` is `true`.

Business.DoingBusinessAsstringOptional

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

Business.BusinessTaxIdstringOptional

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

Business.EinstringOptional

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

Business.OperationStartDatestringOptional

Date the business began operations. Required when `InOperation` is `true`. Format: `yyyyMMdd`.

Business.OperateEstDatestringOptional

Estimated date operations will begin. Required when `InOperation` is `false`. Format: `yyyyMMdd`.

Business.NumberOfMonthlyStablecoinConversionsDepositsnumberOptional

Expected monthly stablecoin deposit conversion count. Required when `HasCoinConversionPlan` is `true`.

Business.AmountOfMonthlyStablecoinConversionsDepositsnumberOptional

Expected monthly stablecoin deposit conversion amount. Required when `HasCoinConversionPlan` is `true`.

Business.NumberOfMonthlyStablecoinConversionsPaymentsnumberOptional

Expected monthly stablecoin payment conversion count. Required when `HasCoinConversionPlan` is `true`.

Business.AmountOfMonthlyStablecoinConversionsPaymentsnumberOptional

Expected monthly stablecoin payment conversion amount. Required when `HasCoinConversionPlan` is `true`.

Business.CountOfMonthlyCryptocurrencyConversionsnumberOptional

Expected monthly cryptocurrency conversion count. Required when `HasCryptoConversionPlan` is `true`.

Business.AmountOfMonthlyCryptocurrencyConversionsnumberOptional

Expected monthly cryptocurrency conversion amount. Required when `HasCryptoConversionPlan` is `true`.

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": {
    "Type": 1,
    "EntityType": "Limited_Liability_Company",
    "AmountOfInitialDeposit": 10000,
    "AverageBalance": 50000,
    "NumberOfMonthlyAchDeposits": 5,
    "AmountOfMonthlyAchDeposits": 10000,
    "NumberOfMonthlyDomesticWireDeposits": 3,
    "AmountOfMonthlyDomesticWireDeposits": 20000,
    "NumberOfMonthlyInternationalWireDeposits": 2,
    "AmountOfMonthlyInternationalWireDeposits": 15000,
    "NumberOfMonthlyAchPayments": 4,
    "AmountOfMonthlyAchPayments": 8000,
    "NumberOfMonthlyDomesticWirePayments": 3,
    "AmountOfMonthlyDomesticWirePayments": 12000,
    "NumberOfMonthlyInternationalWirePayments": 1,
    "AmountOfMonthlyInternationalWirePayments": 5000,
    "ExpectedAmountMonthlyDigitalCurrencyCustody": 0,
    "CountOfMonthlyCryptocurrencyConversions": 1,
    "AmountOfMonthlyCryptocurrencyConversions": 2000,
    "NumberOfMonthlyStablecoinConversionsDeposits": 2,
    "AmountOfMonthlyStablecoinConversionsDeposits": 4000,
    "NumberOfMonthlyStablecoinConversionsPayments": 2,
    "AmountOfMonthlyStablecoinConversionsPayments": 4000,
    "HasBusinessPlan": true,
    "Businesses": [
      "MSB_Crypto_Exchange_OTC_Liquidity_Provider_Remittance_FX_Business"
    ],
    "SignerFirstName": "Ada",
    "SignerMiddleName": "Mary",
    "SignerLastName": "Lovelace",
    "Tnc": true,
    "AcceptDelarationAggrement": true,
    "Signature": "Ada Lovelace",
    "RegulatedDisclosure": false,
    "RegulatoryAgency": [
      "OFAC"
    ],
    "MoneyServicesBusiness": false,
    "PrimaryBusinessModel": "Wholesale distribution to retail partners under annual supply agreements.",
    "MerchantAcquirerPsp": false,
    "Phone": "2025550126",
    "PrimaryBusinessActivities": "Wholesale distribution of consumer electronics to retail partners across the United States.",
    "BusinessProductServices": "Consumer electronics: laptops, tablets, and accessories sold to retail chains.",
    "CustomerDescription": "Mid-size retail chains and independent electronics stores in the United States.",
    "BusSourceOfFunds": [
      "revenue_from_business_operations"
    ],
    "IllegalImmoralDisclosure": [
      "none_of_the_above"
    ],
    "DepositReasons": [
      "receiving_funds_against_invoices_from_customer"
    ],
    "PaymentReasons": [
      "trade_supplier_expense"
    ],
    "DepositLocations": [
      "usa"
    ],
    "PaymentLocations": [
      "usa"
    ],
    "HasEntity": true,
    "Penalty": false,
    "Litigation": false,
    "LiquidFunds": false,
    "BankAccountAnotherFinancialInstitution": true,
    "AdditionalBankAccountInstName": "Example Bank",
    "MobileCountryCode": 1,
    "LandlineCountryCode": 1,
    "MobilePhone": "2025550125",
    "LandlinePhone": "2025550127",
    "Website": true,
    "Url": "https://www.example.com",
    "Engage": "Wholesale distribution of consumer electronics to retail partners.",
    "EmpCount": "11_25",
    "BusinessName": "Example Holdings LLC",
    "DoingBusinessAs": "Example Holdings",
    "BusinessRegistrationCountry": "US",
    "BusinessTaxId": "12-3456789",
    "Ein": "123456789",
    "BusinessRegistrationNumber": "12345678",
    "BusinessFormationDate": "20200101",
    "InOperation": true,
    "OperationStartDate": "20200201",
    "OperateEstDate": "20200301",
    "BusinessIndustryType": "wholesale",
    "InternationalCustomers": [
      "Afghanistan"
    ],
    "HasCoinConversionPlan": false,
    "HasCryptoConversionPlan": false,
    "DealsInCryptocurrency": false,
    "Address": {
      "Street": "Example Street",
      "BuildingNumber": "221B",
      "City": "London",
      "State": "London",
      "PinCode": "NW16XE",
      "Country": "US"
    },
    "AddressList": [
      {
        "Street": "Example Street",
        "BuildingNumber": "221B",
        "City": "London",
        "State": "London",
        "PinCode": "NW16XE",
        "Country": "US",
        "Type": "MAILING"
      },
      {
        "Street": "Example Street",
        "BuildingNumber": "221B",
        "City": "London",
        "State": "London",
        "PinCode": "NW16XE",
        "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"
        ]
      }
    ]
  },
  "PrimaryIndividual": {
    "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": "Boston",
      "State": "Massachusetts",
      "PinCode": "02101",
      "Country": "US"
    },
    "Card": 1,
    "MailingAddress": {
      "Street": "Example Street",
      "BuildingNumber": "221B",
      "City": "Boston",
      "State": "Massachusetts",
      "PinCode": "02101",
      "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 object. `ApplicationId` is the application ID to use on all subsequent calls (GET detail, submit-individual, ask/answer, document/upload, etc.).

Example response

{
  "ResponseCode": 200,
  "ResponseMessage": "Success",
  "ResponseData": {
    "Version": 0,
    "Id": "6a585058e557d865e30a8d4f",
    "Type": 1,
    "CreatedAt": 1784172632,
    "UpdatedAt": 1784172632,
    "EntityType": "Limited_Liability_Company",
    "AmountOfInitialDeposit": 10000,
    "AverageBalance": 50000,
    "NumberOfMonthlyAchDeposits": 5,
    "AmountOfMonthlyAchDeposits": 10000,
    "NumberOfMonthlyDomesticWireDeposits": 3,
    "AmountOfMonthlyDomesticWireDeposits": 20000,
    "NumberOfMonthlyInternationalWireDeposits": 2,
    "AmountOfMonthlyInternationalWireDeposits": 15000,
    "NumberOfMonthlyAchPayments": 4,
    "AmountOfMonthlyAchPayments": 8000,
    "NumberOfMonthlyDomesticWirePayments": 3,
    "AmountOfMonthlyDomesticWirePayments": 12000,
    "NumberOfMonthlyInternationalWirePayments": 1,
    "AmountOfMonthlyInternationalWirePayments": 5000,
    "ExpectedAmountMonthlyDigitalCurrencyCustody": 0,
    "CountOfMonthlyCryptocurrencyConversions": 1,
    "AmountOfMonthlyCryptocurrencyConversions": 2000,
    "NumberOfMonthlyStablecoinConversionsDeposits": 2,
    "AmountOfMonthlyStablecoinConversionsDeposits": 4000,
    "NumberOfMonthlyStablecoinConversionsPayments": 2,
    "AmountOfMonthlyStablecoinConversionsPayments": 4000,
    "HasBusinessPlan": true,
    "Businesses": [
      "MSB_Crypto_Exchange_OTC_Liquidity_Provider_Remittance_FX_Business"
    ],
    "SignerFirstName": "Ada",
    "SignerMiddleName": "Mary",
    "SignerLastName": "Lovelace",
    "Tnc": true,
    "AcceptDelarationAggrement": true,
    "Signature": "Ada Lovelace",
    "RegulatedDisclosure": false,
    "RegulatoryAgency": [
      "OFAC"
    ],
    "MoneyServicesBusiness": false,
    "PrimaryBusinessModel": "Wholesale distribution to retail partners under annual supply agreements.",
    "MerchantAcquirerPsp": false,
    "Phone": "2025550126",
    "PrimaryBusinessActivities": "Wholesale distribution of consumer electronics to retail partners across the United States.",
    "BusinessProductServices": "Consumer electronics: laptops, tablets, and accessories sold to retail chains.",
    "CustomerDescription": "Mid-size retail chains and independent electronics stores in the United States.",
    "BusSourceOfFunds": [
      "revenue_from_business_operations"
    ],
    "IllegalImmoralDisclosure": [
      "none_of_the_above"
    ],
    "DepositReasons": [
      "receiving_funds_against_invoices_from_customer"
    ],
    "PaymentReasons": [
      "trade_supplier_expense"
    ],
    "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
      }
    ],
    "Penalty": false,
    "Litigation": false,
    "LiquidFunds": false,
    "BankAccountAnotherFinancialInstitution": true,
    "AdditionalBankAccountInstName": "Example Bank",
    "MobileCountryCode": 1,
    "LandlineCountryCode": 1,
    "MobilePhone": "2025550125",
    "LandlinePhone": "2025550127",
    "Website": true,
    "Url": "https://www.example.com",
    "Engage": "Wholesale distribution of consumer electronics to retail partners.",
    "EmpCount": "11_25",
    "BusinessName": "Example Holdings LLC",
    "DoingBusinessAs": "Example Holdings",
    "AddressList": [
      {
        "City": "London",
        "State": "London",
        "Country": "US",
        "PinCode": "NW16XE",
        "Street": "Example Street",
        "BuildingNumber": "221B",
        "Type": "MAILING"
      },
      {
        "City": "London",
        "State": "London",
        "Country": "US",
        "PinCode": "NW16XE",
        "Street": "Example Street",
        "BuildingNumber": "221B",
        "Type": "REGISTERED"
      }
    ],
    "Address": {
      "City": "London",
      "State": "London",
      "Country": "US",
      "PinCode": "NW16XE",
      "Street": "Example Street",
      "BuildingNumber": "221B"
    },
    "BusinessRegistrationCountry": "US",
    "BusinessTaxId": "12-3456789",
    "Ein": "123456789",
    "BusinessRegistrationNumber": "12345678",
    "BusinessFormationDate": "20200101",
    "InOperation": true,
    "OperationStartDate": "20200201",
    "OperateEstDate": "20200301",
    "BusinessIndustryType": "wholesale",
    "InternationalCustomers": [
      "Afghanistan"
    ],
    "HasCoinConversionPlan": false,
    "HasCryptoConversionPlan": false,
    "DealsInCryptocurrency": false
  }
}

On create, `Version` will be 0. On re-submit, `Version` increments. Use `ApplicationId` from the response as the `id` path param for `GET /application/detail/{id}` 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

↑↓navigateopenEscclose