---
title: "Submit onboarding data"
method: POST
path: "/submit-onboarding-data"
tags: ["Onboarding"]
---

# Submit onboarding data

`POST /submit-onboarding-data`

Submit onboarding data for applicants to pre-fill their Mercury application

## Request body

- APISubmitOnboardingDataParams
  - `about` APIOnboardingDataAbout
    - `countriesOfOperations` ISO3166Alpha2[], nullable — The countries where the company operates.
    - `countryOfOperation` string
    - `description` string, nullable
    - `industry` string, nullable
    - `legalBusinessName` string, nullable
    - `website` string, nullable
  - `applicationType` 'PendingEINApplication' | 'DefaultApplication'
  - `beneficialOwners` APIBeneficialOwner[], required
    - `address1` string, nullable — Address line 1 of Beneficial Owner's address
    - `address2` string, nullable — Address line 2 of Beneficial Owner's address
    - `citizenshipStatus` 'USCitizen' | 'USResident' | 'NonResident', nullable — Beneficial Owner's Citizenship Status
    - `city` string, nullable — City of Beneficial Owner's address
    - `country` string, nullable — Country of Beneficial Owner's address
    - `dateOfBirth` string, date, nullable — Beneficial Owner's Date of Birth
    - `email` string, nullable — Beneficial Owner's Email Address
    - `firstName` string, nullable — Beneficial Owner's First Name
    - `identificationBlob` string, nullable — Beneficial Owner's Identification File
    - `identificationType` 'Passport' | 'DriversLicense' | 'StateID' | 'AlienRegistrationCard' | 'EmployeeAuthorizationDocument' | 'VerifiedByThirdParty' | 'NationalID' | 'ResidencePermit' | 'Visa', nullable — Beneficial Owner's Identification File Type
    - `isPep` 'IsPep' | 'IsNotPep', nullable — Beneficial Owner's pep status
    - `jobTitle` 'ChiefExecutiveOfficer' | 'ChiefOperatingOfficer' | 'ChiefTechnologyOfficer' | 'ChiefFinancialOfficer' | 'Founder' | 'President' | 'GeneralPartner' | 'FinanceTeam' | 'Other', nullable — Beneficial Owner's Job Title
    - `lastName` string, nullable — Beneficial Owner's Last Name
    - `otherJobTitle` string, nullable — Beneficial Owner's Alternate Job Title
    - `percentOwnership` number, nullable — Beneficial Owner's Ownership Percentage
    - `phoneNumber` string, nullable — Beneficial Owner's Phone Number
    - `postalCode` string, nullable — Postal Code of Beneficial Owner's address
    - `region` string, nullable — Region or State of Beneficial Owner's address
    - `socialProfileLinks` string[], nullable — Beneficial Owner's Social Profile Websites
    - `state` string, nullable — State or Region of Beneficial Owner's address (Deprecated)
  - `businessContactDetails` APIBusinessContactDetails
    - `address1` string, nullable
    - `address2` string, nullable
    - `city` string, nullable
    - `country` string
    - `phoneNumber` string, nullable
    - `postalCode` string, nullable
    - `state` string
  - `businessLegalAddress` APIBusinessAddress
    - `address1` string, nullable
    - `address2` string, nullable
    - `city` string, nullable
    - `country` string
    - `postalCode` string, nullable
    - `region` string
  - `businessPhysicalAddress` APIBusinessAddress
    - `address1` string, nullable
    - `address2` string, nullable
    - `city` string, nullable
    - `country` string
    - `postalCode` string, nullable
    - `region` string
  - `formationDetails` APIFormationDetails
    - `companyOriginCountry` string
    - `companyStructure` 'CCorp' | 'LLC' | 'LLP' | 'NonProfit' | 'Partnership' | 'ProfessionalAssociation' | 'ProfessionalCorporation' | 'SCorp' | 'GeneralPartnership' | 'LimitedPartnership' | 'JointVenture' | 'LLCTaxedAsSoleProprietorship' | 'SoleProprietorship' | 'ExemptedCompany' | 'Limited'
    - `eINDocumentFileBlob` string, nullable
    - `einDocumentFileBlob` string, nullable
    - `federalEin` string, nullable, required — Field should be null (no value), 'Pending' (value will be provided at a later date), or a valid value
    - `foreignBusinessNumber` string, nullable
    - `formationDocumentFileBlob` string, nullable, required — Field should be null (no value), 'Pending' (value will be provided at a later date), or a valid value
    - `formationDocumentType` 'ArticlesOfIncorporation' | 'ArticlesOfOrganization' | 'CertificateOfFormation' | 'PartnershipAgreement' | 'SecretaryOfStateRegistrationPage'
  - `inviteEmail` string
  - `partner` string, required
  - `webhookURL` string, nullable

## Response `200`

- APISubmitOnboardingDataResponse
  - `onboardingDataId` string, uuid, required — ID for this saved onboarding data
  - `signupLink` string, required

## Other responses

- `400` — Invalid `body`

---

[API](https://skmtc.net/mercurytechnologies/apis/mercury-api.md) · [All operations](https://skmtc.net/mercurytechnologies/apis/mercury-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mercurytechnologies/mercury-api/revisions/0bdf4a496e03/schema)