Company onboarding requirements

Before creating a company onboarding, review what Swan collects, the recommended identification levels, and the requirements for your account countries.

Collecting onboarding information

Company onboarding information can be submitted with the API or through Swan's onboarding form.

Method	Details
Onboarding form	The onboarding form collects: User's email address. Legal information about the organization, including the company name, registration number, VAT number (optional), and address, as well as details about the organization's activity and expected monthly volume. Information about the company's related individuals (ultimate beneficial owners (UBOs) and legal representatives). Information about the company's related companies (legal entity representatives, if applicable). Required documents to verify your organization. You might not see this step in your onboarding process. User signs up for Swan. You can also customize this form to better meet your needs. Review Swan's open source documentation, then ask your PIM (Product Integration Manager) for more information.
API	The API collects the same information as the onboarding form. Review the requirements explained on this page thoroughly, then follow the guide to create a company onboarding link.

Expected monthly volume

Swan uses the expected monthly volume provided during onboarding to monitor the account. It's essential to select the range that corresponds to the company's actual volume, and to notify Swan if that expected monthly volume changes during the account's lifecycle.

If you use Swan's onboarding form, this information is collected by default. If you design your own form, offer the following ranges:

• Less than €10,000 (LessThan10000).
• Between €10,000 and €50,000 (Between10000And50000).
• Between €50,000 and €100,000 (Between50000And100000).
• More than €100,000 (MoreThan100000).

Related individuals

The new API uses the company.relatedIndividuals array to represent all individuals connected to the company. Each individual has a type that determines their role:

• LegalRepresentative: the individual represents the company legally.
• UltimateBeneficialOwner: the individual holds ownership or control over the company (25% or more of the company's value, directly or indirectly).
• LegalRepresentativeAndUltimateBeneficialOwner: the individual serves both roles.

Finalization requirements

At least one legal representative and one UBO are required to finalize a company onboarding. The same individual can fulfill both roles by using the LegalRepresentativeAndUltimateBeneficialOwner type.

Related companies

Use the company.relatedCompanies array when a legal entity (not an individual) serves as a representative for the account holder company. Each entry requires the company's entityName, registrationNumber, registrationCountry, and roles.

Legal form code

The legalFormCode field is required for all company onboardings. Use the legalForms query to retrieve all valid legal forms for a given country, translated based on the Accept-Language header. Each legal form includes a code you can use as the legalFormCode value.

Retrieving data automatically

For companies located in France, use the companyInfoRegistryData query to retrieve data from the National Business Register (RNE) using the company's registration number. Pass the results to the create or update mutation to pre-fill company fields.

No auto-population

The new API doesn't auto-populate fields. You must call companyInfoRegistryData and pass the results to the createCompanyAccountHolderOnboarding or updateCompanyAccountHolderOnboarding mutation to pre-fill company fields.

Identification recommendations

Swan must verify the identity of the legal representative for each company. Swan supports multiple identification processes, and some require a first transfer. Refer to identification recommendations by country for the recommended and supported levels per account country, including recommendations for self-employed account holders.

Country requirements for company accounts

Requirements vary country to country when opening any type of Swan account. Requirements for company accounts are different than for individual accounts, and there is also a different mutation.

For company accounts, use the createCompanyAccountHolderOnboarding mutation. For a complete list of fields, country-specific requirements, and conditional rules, refer to the company onboarding field reference.

User flow diagrams

End-user perspective of a company account onboarding