entityRequiredFields

Response

Variable	Example	Enum
email	[email protected]	-
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

Business documents are required to be in English

Supported business types

{
    "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:

Standard Flow:

query entityRequiredFields -> mutation createBusinessEntity -> mutation finalizeEntity

Flow with Representatives:

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

GraphQL Schema

query entityRequiredFields (
    $country: ISO3166_1
    $entity_type: EntityType
    $business_type: BusinessType
) {
    entityRequiredFields (  
        country: $country 
        entity_type: $entity_type
        business_type: $business_type
    ) {
        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.

Compliance Onboarding