--- title: "POST /onboardings/individual" method: POST path: "/onboardings/individual" tags: ["onboardings"] --- # POST /onboardings/individual `POST /onboardings/individual` If the account’s profile status is awaiting_information, start the onboarding flow. To initiate the Online Onboarding process using the POST/onboardings/individual endpoint, you need to submit the same data you used for account creation, along with the accountId (Id) provided in the response. All other data are optional to initiate an Online Onboarding and will be collected directly from the end-user, ensuring compliance with KYC requirements without additional data input from your side. Note: Some end-user personal information may be pre-filled when they open onboarding page for the first time, notably the name, email and contact details. We use the initial end-user data you sent us to inject into online onboarding page. When you submit the payload, the API will: • Identify the account and link the KYC process to it. • All mandatory personal, contact, and address data for identity checks. • Assesses AML/PEP risk via political exposure, financial profile, and source of funds. • Verifies legal eligibility (age, capacity). • Understands the user’s business intent (FAREWELL project) and downstream beneficiary. • Redirects the user back to your specified redirectUrl once all steps succeed (or fail). ## Request body - CreateIndividualOnboardingRequest - `accountId` string, required — UUID of the previously created account - `redirectUrl` string — URL to which the user will be redirected after completing onboarding - `individual` OnboardingIndividual, required - `firstName` string, required — Official first name that appears on the user's legal documents, such as a passport. - `lastName` string, required — Official last name that appears on the user's legal documents. - `otherName` string — Maiden name/married name, used name, ps - `birthDate` string, required — Format: YYYY-MM-DD - `birthCity` string — City of birth - `birthCountry` string, required — ISO-2 format - `birthProvince` 'AG' | 'AL' | 'AN' | 'AO' | 'AP' | 'AQ' | 'AR' | 'AT' | 'AV' | 'BA' | 'BG' | 'BI' | 'BL' | 'BN' | 'BO' | 'BR' | 'BS' | 'BT' | 'BZ' | 'CA' | 'CB' | 'CE' | 'CH' | 'CI' | 'CL' | 'CN' | 'CO' | 'CR' | 'CS' | 'CT' | 'CZ' | 'EE' | 'EN' | 'FC' | 'FE' | 'FG' | 'FI' | 'FM' | 'FO' | 'FR' | 'FU' | 'GE' | 'GO' | 'GR' | 'IM' | 'IS' | 'KR' | 'LC' | 'LE' | 'LI' | 'LO' | 'LT' | 'LU' | 'MB' | 'MC' | 'ME' | 'MI' | 'MN' | 'MO' | 'MS' | 'MT' | 'MZ' | 'NA' | 'NO' | 'NU' | 'OG' | 'OR' | 'OT' | 'PA' | 'PC' | 'PD' | 'PE' | 'PG' | 'PI' | 'PL' | 'PN' | 'PO' | 'PR' | 'PT' | 'PU' | 'PV' | 'PZ' | 'RA' | 'RC' | 'RE' | 'RG' | 'RI' | 'RM' | 'RN' | 'RO' | 'SA' | 'SI' | 'SO' | 'SP' | 'SR' | 'SS' | 'SU' | 'SV' | 'TA' | 'TE' | 'TN' | 'TO' | 'TP' | 'TR' | 'TS' | 'TV' | 'UD' | 'VA' | 'VB' | 'VC' | 'VE' | 'VI' | 'VR' | 'VS' | 'VT' | 'VV' - `nationalities` string[], required — ISO-2 format. Allows multiple nationalities - `email` string, required - `phoneNumber` string — Must include country code - `address` OnboardingAddress, required — Address of the representative - `street` string - `complementaryStreetInfo` string - `city` string - `postalCode` string - `country` string, required — ISO-2 format - `province` 'AG' | 'AL' | 'AN' | 'AO' | 'AP' | 'AQ' | 'AR' | 'AT' | 'AV' | 'BA' | 'BG' | 'BI' | 'BL' | 'BN' | 'BO' | 'BR' | 'BS' | 'BT' | 'BZ' | 'CA' | 'CB' | 'CE' | 'CH' | 'CI' | 'CL' | 'CN' | 'CO' | 'CR' | 'CS' | 'CT' | 'CZ' | 'EE' | 'EN' | 'FC' | 'FE' | 'FG' | 'FI' | 'FM' | 'FO' | 'FR' | 'FU' | 'GE' | 'GO' | 'GR' | 'IM' | 'IS' | 'KR' | 'LC' | 'LE' | 'LI' | 'LO' | 'LT' | 'LU' | 'MB' | 'MC' | 'ME' | 'MI' | 'MN' | 'MO' | 'MS' | 'MT' | 'MZ' | 'NA' | 'NO' | 'NU' | 'OG' | 'OR' | 'OT' | 'PA' | 'PC' | 'PD' | 'PE' | 'PG' | 'PI' | 'PL' | 'PN' | 'PO' | 'PR' | 'PT' | 'PU' | 'PV' | 'PZ' | 'RA' | 'RC' | 'RE' | 'RG' | 'RI' | 'RM' | 'RN' | 'RO' | 'SA' | 'SI' | 'SO' | 'SP' | 'SR' | 'SS' | 'SU' | 'SV' | 'TA' | 'TE' | 'TN' | 'TO' | 'TP' | 'TR' | 'TS' | 'TV' | 'UD' | 'VA' | 'VB' | 'VC' | 'VE' | 'VI' | 'VR' | 'VS' | 'VT' | 'VV' — Province - `taxCode` string — Specific tax code format. Only if resident of France - `politicalExposure` PoliticalExposure — Political exposure details (PEP status) - `status` 'YES' | 'NO' | 'CLOSE', required — Politically exposed person status - `position` 'POLITICAL_LEADER' | 'POLITICAL_REPRESENTATIVE' | 'JUDICIAL_OFFICIAL' | 'FINANCIAL_AUDITOR' | 'BANK_EXECUTIVE' | 'DIPLOMATIC_REPRESENTATIVE' | 'MILITARY_LEADER' | 'ADMINISTRATIVE_OFFICIAL' | 'ORGANIZATIONAL_OFFICIAL' | 'OTHER' — There are 9 identified positions and one option to state another if not on the list - `startDate` string — Format: YYYY-MM-DD - `endDate` string — Format: YYYY-MM-DD. If unknown, not required - `fullName` string — Full legal name of the politically exposed person - `closeRelationship` 'PARTNER' | 'CHILD' | 'PARENT' — CloseRelationshipType - `otherPosition` string — State official position if not in provided list - `financialSituation` OnboardingFinancialSituation - `annualRevenue` 'FIRST_TIER' | 'SECOND_TIER' | 'THIRD_TIER' | 'FOURTH_TIER' | 'FIFTH_TIER' | 'SIXTH_TIER' — 6 tiers format in Euro. •FIRST_TIER: 0 - 100K€ •SECOND_TIER: 100K€ - 200K€ •THIRD_TIER: 500K€ - 1.5M€ •FOURTH_TIER: 1.5M€ - 5M€ •FIFTH_TIER: 5M€ - 20M€ •SIXTH_TIER: 20M€ - 100M€ - `estimatedWealth` 'FIRST_TIER' | 'SECOND_TIER' | 'THIRD_TIER' | 'FOURTH_TIER' | 'FIFTH_TIER' | 'SIXTH_TIER' | 'SEVENTH_TIER' — 7 tiers format in Euro •FIRST_TIER: 0 - 100K€ •SECOND_TIER: 100K€ - 200K€ •THIRD_TIER: 500K€ - 1.5M€ •FOURTH_TIER: 1.5M€ - 5M€ •FIFTH_TIER: 5M€ - 20M€ •SIXTH_TIER: 20M€ - 100M€ •SEVENTH_TIER: >100M€ - `hasIFItax` boolean — Boolean statement - `originOfFunds` OriginOfFunds - `sources` string[], required - `other` string — Description of other origin of funds - `legalCapacity` LegalCapacity - `type` 'MINOR_EMANCIPATED' | 'MINOR_NOT_EMANCIPATED' | 'LEGAL_AGE_AND_CAPACITY' | 'PROTECTED_ADULT', required — Legal capacity options: LEGAL_AGE_AND_CAPACITY, PROTECTED_ADULT, MINOR_EMANCIPATED, MINOR_NOT_EMANCIPATED - `protectionType` 'SAFEGUARDING_OF_JUSTICE' | 'CURATORSHIP' | 'GUARDIANSHIP' | 'OTHER' - `otherProtectionType` string — Must specify other protection type - `professionalSituation` ProfessionalSituation - `activity` '1000' | '2000' | '3000' | '4000' | '5000' | '6000' | '0000' | '8100' | '8300' | '8400' | '8500' | '8600' | '1' | '23' | '21' | '22' | '31' | '33A' | '33B' | '33C' | '33D' | '33E' | '34' | '35A' | '35B' | '35C' | '35D' | '37' | '38A' | '38B' | '38C' | '38D' | '38E' | '38F' | '38G' | '42A' | '42B' | '42C' | '43A' | '43B' | '43C' | '43D' | '44A' | '45' | '46A' | '46B' | '46C' | '46D' | '46E' | '46F' | '46G' | '47' | '48' | '52A' | '52B' | '52C' | '53A' | '53B' | '53C' | '53D' | '54' | '55' | '56A' | '56B' | '56C' | '56D' | '56E' | '56F' | '62' | '63' | '65' | '66' | '67' | '68' | '69' — ProfessionalActivity - `project` OnboardingProject - `type` 'WEDDING' | 'FAREWELL' | 'NEW_BORN' | 'BIRTHDAY' | 'CHARITY' | 'OTHER' | 'SALARY_ADVANCE' — type - `beneficiary` Beneficiary - `firstName` string - `lastName` string - `birthDate` string, date-time - `website` string - `description` string - `weddingRelation` 'BRIDE_GROOM' | 'OTHER' — WeddingRelationType - `weddingPartnerFirstName` string — Must be official person's name - `weddingPartnerLastName` string — Must be official person's name - `salaryAdvanceReason` SalaryAdvanceReason - `type` string - `other` string - `financialSupport` FinancialSupport - `visaApplicantRole` 'STUDENT' | 'JOB_SEEKER', required - `isPayer` boolean, required - `payerRelationship` PayerRelationship, required - `link` 'MOTHER_FATHER' | 'RELATIVES' | 'SIBLINGS' | 'GRAND_PARENTS' | 'HUSBAND_WIFE' | 'LIFE_PARTNER' | 'OTHER', required - `other` string - `financialSituation` PayerFinancialSituation, required - `annualRevenue` 'FIRST_TIER' | 'SECOND_TIER' | 'THIRD_TIER' | 'FOURTH_TIER' | 'FIFTH_TIER' | 'SIXTH_TIER', required — 6 tiers format in Euro. •FIRST_TIER: 0 - 100K€ •SECOND_TIER: 100K€ - 200K€ •THIRD_TIER: 500K€ - 1.5M€ •FOURTH_TIER: 1.5M€ - 5M€ •FIFTH_TIER: 5M€ - 20M€ •SIXTH_TIER: 20M€ - 100M€ - `estimatedWealth` 'FIRST_TIER' | 'SECOND_TIER' | 'THIRD_TIER' | 'FOURTH_TIER' | 'FIFTH_TIER' | 'SIXTH_TIER' | 'SEVENTH_TIER', required — 7 tiers format in Euro •FIRST_TIER: 0 - 100K€ •SECOND_TIER: 100K€ - 200K€ •THIRD_TIER: 500K€ - 1.5M€ •FOURTH_TIER: 1.5M€ - 5M€ •FIFTH_TIER: 5M€ - 20M€ •SIXTH_TIER: 20M€ - 100M€ •SEVENTH_TIER: >100M€ - `originOfFunds` OriginOfFunds, required - `sources` string[], required - `other` string — Description of other origin of funds ## Response `201` Onboarding session created successfully - CreateOnboardingResponse - `id` string, required - `url` string, required ## Other responses - `400` — Missing or invalid request parameters - `401` — Missing or invalid authentication token - `404` — Account not found or does not meet onboarding prerequisites - `409` — Onboarding already initiated for this account - `500` — Unexpected error occurred on the server --- [API](https://skmtc.net/lemonway/apis/account-onboarding-management-api.md) · [All operations](https://skmtc.net/lemonway/apis/account-onboarding-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lemonway/account-onboarding-management-api/revisions/73309fe68e2d/schema)