entityRequiredFields

Response

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

{
    "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:
query entityRequiredFields -> mutation createBusinessEntity -> mutation finalizeEntity
  1. 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
platform_id UUID false (required after June 15th 2026)

GraphQL Schema

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.