Onboarding Fields

When you onboard a customer or submit additional information, Lumx collects a set of self-disclosure fields that drive AML risk scoring and routing into Enhanced Due Diligence. This page lists the values each field accepts. Values outside these lists return 400. For the full request schemas, see Create a customer and Send additional information. For the broader onboarding flow, see Individual verification and Business verification.

Customers created before October 28, 2026 answer the previous questionnaire, which uses different fields and values. See Previous questionnaire.

USD amounts

monthlyIncomeInUSD (individuals and their associated parties) and monthlyRevenueInUSD (businesses) take a non-negative amount in USD as a string, with up to 18 integer digits and up to 2 decimal places. For example, "8000" or "8000.50".

Individuals

Professional situation

professionalSituation. Single value. The free-text professionalOccupation field accompanies it to capture the specific role (e.g., “Software Engineer”).

Code	Description
`EMPLOYEE`	Salaried employee.
`SELF_EMPLOYED`	Self-employed or sole proprietor.
`BUSINESS_OWNER`	Owns a business.
`GOVERNMENT_OFFICIAL`	Government official.
`INVESTOR`	Investor.
`STUDENT`	Student.
`RETIRED`	Retired.
`HOMEMAKER`	Homemaker.
`UNEMPLOYED`	Currently unemployed.
`OTHER`	Doesn’t fit the categories above.

Source of funds

sourceOfFunds. The origin of the customer’s funds. Single value.

Code	Description
`SALARY_EMPLOYMENT_INCOME`	Salary or employment income.
`BUSINESS_INCOME_DIVIDENDS`	Business income or dividends.
`SAVINGS_INVESTMENT_RETURNS`	Savings or investment returns.
`PENSION_RETIREMENT`	Pension or retirement income.
`SALE_OF_ASSETS_REAL_ESTATE`	Sale of assets or real estate.
`INHERITANCE_GIFT`	Inheritance or gift.
`LOAN`	Borrowed funds.
`GOVERNMENT_BENEFITS`	Government benefits.
`GAMBLING_LOTTERY_PROCEEDS`	Gambling or lottery proceeds.
`ROYALTIES_INTELLECTUAL_PROPERTY`	Royalties or intellectual property income.
`THIRD_PARTY_FUNDS`	Funds that belong to a third party.
`OTHER`	Doesn’t fit the categories above.

Transaction counterparties

transactionCounterparties. Who the customer expects to send money to or receive it from. Array.

Code	Description
`SELF`	The customer’s own accounts.
`FAMILY`	Family members (e.g., remittances).
`FRIENDS`	Personal acquaintances.
`EMPLOYER`	The customer’s employer.
`MERCHANTS_BUSINESSES`	Merchants or businesses.
`GOVERNMENT`	Government entities.
`OTHER`	Doesn’t fit the categories above.

Businesses

Business activity

businessActivity. What the business does. Single value. See Business Activities for the accepted values.

Monthly transaction volume

monthlyTransactionVolumeInUSD. The expected monthly volume, as a range in USD. Single value.

Code	Range
`UP_TO_100K`	Up to $100K.
`100K_TO_1M`	$100K to $1M.
`1M_TO_5M`	$1M to $5M.
`5M_TO_10M`	$5M to $10M.
`10M_TO_20M`	$10M to $20M.
`20M_TO_30M`	$20M to $30M.
`OVER_30M`	Over $30M.

Source of funds

sourceOfFunds. The origin of the business’s funds. Single value.

Code	Description
`OPERATING_SERVICE_REVENUE`	Operating or service revenue.
`INVESTMENT_RETURNS_CAPITAL_GAINS`	Investment returns or capital gains.
`ASSET_BUSINESS_SALE`	Sale of assets or of a business.
`SHAREHOLDER_EQUITY_RAISE`	Shareholder contributions or equity raise.
`LOAN`	Borrowed funds.
`INTERCOMPANY_TRANSFER`	Transfer from a related company.
`GRANT`	Government or institutional grant.
`CRYPTOCURRENCY_DIGITAL_ASSETS`	Cryptocurrency or digital assets.
`ROYALTIES_AFFILIATE_INCOME`	Royalties or affiliate income.
`LEGAL_SETTLEMENT_SUCCESSION`	Legal settlement or succession.
`GAMBLING_REVENUE`	Gambling revenue.
`CHARITABLE_CONTRIBUTIONS`	Charitable contributions.
`OTHER`	Doesn’t fit the categories above.

When more than one source of funds applies, pick the primary one. Compliance may request supporting evidence regardless. See Document Types.

Transaction counterparties

transactionCounterparties. Who the business expects to send money to or receive it from. Array.

Code	Description
`OWN_ACCOUNTS_INTERCOMPANY`	The business’s own accounts or group companies.
`SHAREHOLDERS_PARTNERS`	Shareholders or partners.
`CUSTOMERS`	The business’s clients or buyers.
`MERCHANTS`	Merchants.
`SUPPLIERS_VENDORS`	Suppliers or vendors.
`EMPLOYEES`	Payroll, salaries, or reimbursements.
`CONTRACTORS`	Independent contractors or freelancers.
`FINANCIAL_INSTITUTIONS_VASP`	Financial institutions or virtual asset service providers.
`INVESTMENT_COUNTERPARTIES`	Investment counterparties.
`GOVERNMENT_TAX_AUTHORITIES`	Government or tax authorities.
`AFFILIATED_COMPANIES`	Affiliated companies.
`OTHER`	Doesn’t fit the categories above.

Previous questionnaire

Customers created before October 28, 2026 keep answering the previous questionnaire. Their additional information uses jurisdictions and involvedActivities and, for businesses, companyType, annualRevenue, monthlyTransactionVolume, and complianceAndAML, with the values below. A body that doesn’t match the customer’s questionnaire returns 400 with VALIDATION_ERROR. See the changelog for the full list of differences.

jurisdictions

Regions where transactions are expected to occur. Array. Submit every region that applies. This field is separate from the customer’s country of residence or incorporation.

Code	Description
`BRA`	Brazil.
`USA`	United States.
`EU`	European Union.
`CANADA`	Canada.
`CHINA`	China.
`MEXICO`	Mexico.
`OTHERS`	Any other region. Use alongside the specific countries above when activity spans further.

involvedActivities

Self-disclosure of involvement with high-risk activities. Array. Must include NONE if none apply. Disclosing any value other than NONE does not pre-approve the activity.

Code	Description
`NONE`	None of the activities below apply.
`ADULT_ENTERTAINMENT`	Adult-content businesses or services.
`DRUGS`	Drugs, controlled substances, or unlicensed pharmaceuticals.
`FIREARMS`	Weapons, ammunition, or related products.
`GAMBLING`	Gambling, betting, or games of chance.
`MARIJUANA`	Cannabis-related business.
`TUMBLING`	Crypto mixers, tumblers, or anonymity-enhancing services.

transactionCounterparties

Who the customer expects to send money to or receive it from. Array.

Code	Description
`SELF`	Transfers between the customer’s own accounts.
`MERCHANTS_SUPPLIERS`	Vendors, suppliers, or service providers.
`CUSTOMERS`	The customer’s own clients or buyers.
`EMPLOYEES`	Payroll, salaries, or reimbursements.
`CONTRACTORS`	Independent contractors or freelancers.
`FRIENDS`	Personal acquaintances (individual customers only).
`FAMILY`	Family members (individual customers only, e.g. remittances).

sourceOfFunds

The origin of the customer’s funds. Single value.

Code	Description	Typical use
`EMPLOYMENT`	Salary or wages.	Individuals.
`SAVINGS`	Accumulated savings.	Individuals.
`WINNINGS`	Lottery, gambling, or contest winnings.	Individuals.
`MARITAL`	Funds received through marriage (dowry, alimony, settlement).	Individuals.
`REAL_ESTATE`	Sale or rental of real property.	Individuals and businesses.
`TRUST`	Distribution from a trust.	Individuals.
`INVESTMENT`	Returns from investments.	Individuals and businesses.
`COMPANY`	Operating revenue.	Businesses.
`COMPANY_CAPITAL`	Capital contributions to the business.	Businesses.
`LOAN`	Borrowed funds.	Individuals and businesses.
`PRIVATE_CAPITAL`	Private equity or venture capital.	Businesses.
`GRANT`	Government or institutional grant.	Businesses, NGOs.
`OTHER`	Doesn’t fit the categories above. Use sparingly.	—

professionalSituation (individuals)

Code	Description
`EMPLOYEE`	Salaried employee.
`SELF_EMPLOYED`	Self-employed or sole proprietor.
`UNEMPLOYED`	Currently unemployed.
`RETIRED`	Retired.
`OTHER`	Doesn’t fit the categories above.

companyType (businesses)

See Previous questionnaire on the Business Activities page.

Business Activities

Accepted values for businessActivity on KYB.

Supported countries

Jurisdiction tiers and EDD scope.

Prohibited activities

Activity categories Lumx does not service.

Document Types

Supporting evidence Lumx may request during review.

Get Started

Quickstarts

Core Concepts

Compliance

Developer

Additional Information

Onboarding Fields

USD amounts

Individuals

Professional situation

Source of funds

Transaction counterparties

Businesses

Business activity

Monthly transaction volume

Source of funds

Transaction counterparties

Previous questionnaire

Business Activities

Supported countries

Prohibited activities

Document Types

​USD amounts

​Individuals

​Professional situation

​Source of funds

​Transaction counterparties

​Businesses

​Business activity

​Monthly transaction volume

​Source of funds

​Transaction counterparties

​Previous questionnaire

​Related resources

Business Activities

Supported countries

Prohibited activities

Document Types

USD amounts

Individuals

Professional situation

Source of funds

Transaction counterparties

Businesses

Business activity

Monthly transaction volume

Source of funds

Transaction counterparties

Previous questionnaire

Related resources