> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lumx.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Onboarding Fields

> Self-disclosure enums collected on customer creation and additional information requests

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 enum values each field accepts.

For the full request schemas, see [Create a customer](/api-reference/customers/create-a-customer) and [Send additional information](/api-reference/customers/send-additional-information). For the broader onboarding flow, see [Individual verification](/guides/individual-verification) and [Business verification](/guides/business-verification).

## Common to all customers

### Jurisdictions

Regions where transactions are expected to occur. Array. Submit every region that applies.

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

<Info>
  This field is separate from the customer's country of residence/incorporation. For the country-level Supported / EDD / Restricted classification, see [Supported countries](/compliance/supported-countries).
</Info>

### Involved activities

Self-disclosure of involvement with high-risk activities. Array. Must include `NONE` if none apply.

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

<Warning>
  Disclosing any value other than `NONE` does not pre-approve the activity. See [Prohibited business activities](/compliance/prohibited-activities) for the categories Lumx does not service.
</Warning>

### Transaction counterparties

Who the customer expects to transact with. 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). |

This drives which destination [holder relationships](/concepts/destinations#holder-relationships) Lumx expects to see on payouts.

### Source of funds

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

<Info>
  When more than one source applies, pick the primary one. Compliance may request supporting evidence regardless. See [Document Types](/additional-information/document-types).
</Info>

## Individuals only

### Professional situation

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

The free-text `professionalOccupation` field accompanies this to capture the specific role (e.g., "Software Engineer").

## Businesses only

Businesses also disclose their company type. See [Company Types](/additional-information/company-types) for the accepted values.

## Related resources

<CardGroup cols="2">
  <Card title="Company Types" href="/additional-information/company-types">
    Business categorization for `companyType` on KYB.
  </Card>

  <Card title="Supported countries" href="/compliance/supported-countries">
    Jurisdiction tiers and EDD scope.
  </Card>

  <Card title="Prohibited activities" href="/compliance/prohibited-activities">
    Activity categories Lumx does not service.
  </Card>

  <Card title="Document Types" href="/additional-information/document-types">
    Supporting evidence Lumx may request during review.
  </Card>
</CardGroup>