### Response

| Variable                     | Example                        | Enum                                                                                                                                  |
|------------------------------|--------------------------------|---------------------------------------------------------------------------------------------------------------------------------------|
| email                        | [example@email.com](mailto:example@email.com) | -                                                                                                                                     |
| contact_first_name           | John                           | -                                                                                                                                     |
| contact_last_name            | Smith                          | -                                                                                                                                     |
| business_name                | Routefusion                    | -                                                                                                                                     |
| business_address1            | 1 Street                      | -                                                                                                                                     |
| business_country             | US                             | -                                                                                                                                     |
| accept_terms_and_conditions   | true \'|\' false             | -                                                                                                                                     |
| incorporation_date           | 2018-01-04                    | -                                                                                                                                     |
| phone                        | 5129876545                     | -                                                                                                                                     |
| business_type                | limited_liability_company      | sole_proprietorship, general_partnership, limited_partnership, s_corporation, c_corporation, b_corporation, close_corporation, nonprofit_corporation, cooperative, limited_liability_company, non_us |
| requires_representatives      | true                           | -                                                                                                                                     |
| documents                    | proof_of_registration          | proof_of_registration, proof_of_ownership, bank_statement                                                                               |

### Supported business types

```undefined
{
    "sole_proprietorship",
    "general_partnership",
    "limited_partnership",
    "s_corporation",
    "c_corporation",
    "b_corporation",
    "close_corporation",
    "nonprofit_corporation",
    "cooperative",
    "limited_liability_company",
    "non_us"
}
```

### Onboarding Process

The `entityRequiredFields` query returns the onboarding requirements for an entity based on its country of registration, type, and business nature. These requirements define the steps needed for executing `createBusinessEntity` and `createPersonalEntity`.

Entity creation involves multiple steps, detailed in the flows below. If the response contains `required_representatives`, you will need to add representatives to the entity using the `createRepresentative` mutation.

#### Onboarding Flows:

1. **Standard Flow:**

```undefined
query entityRequiredFields -> mutation createBusinessEntity -> mutation finalizeEntity
```

2. **Flow with Representatives:**

```undefined
query entityRequiredFields -> mutation createBusinessEntity -> query representativeRequiredFields -> mutation createRepresentative -> mutation finalizeEntity
```

#### KYB/KYC Document Requirements

We will provide a list of different document combinations to satisfy KYB/KYC requirements. You only need to provide all the documents listed within one of these sets to meet the requirements.

### Parameters

| Parameter        | Type         | Required                           |
|------------------|--------------|------------------------------------|
| `country`        | `ISO3166_1`  | false                             |
| `entity_type`    | `EntityType` | false                             |
| `business_type`  | `BusinessType` | false                             |
| `platform_id`    | `UUID`       | false (required after June 15th 2026) |

### GraphQL Schema

```graphql
query entityRequiredFields (
    $country: ISO3166_1
    $entity_type: EntityType
    $business_type: BusinessType
	$platform_id: UUID
) {
    entityRequiredFields (
        country: $country
        entity_type: $entity_type
        business_type: $business_type
		platform_id: $platform_id
    ) {
        requires_representatives
        documents {
            enum
            type
        }
        fields {
            variable
            regex
            example
            enum
        }
    }
}
```

### **For the countries available for onboarding businesses view here**

Entities registered in a high-risk designated country will require special approval.