---
title: "POST /onboardings/association"
method: POST
path: "/onboardings/association"
tags: ["onboardings"]
---

# POST /onboardings/association

`POST /onboardings/association`

Initiates the online onboarding process for a legal entity whose profile status is AWAITING_INFORMATION. This call generates a secure onboarding session and returns a redirect URL where the end-user can complete their onboarding (e.g., KYC checks, document uploads).

## Request body

- CreateAssociationOnboardingRequest
  - `accountId` string, required — UUID of the previously created account
  - `redirectUrl` string — URL to which the user will be redirected after completing onboarding
  - `legalEntity` AssociationLegalEntity, required — Legal entity details (see nested bodyParams below)
    - `name` string, required — Full legal name of the entity
    - `registrationNumber` string — Official company registration number
    - `registrationDate` string, date-time, required — Date of company registration (ISO 8601)
    - `vatNumber` string — VAT registration number
    - `website` string — Company website URL
    - `noWebsiteReason` string
    - `legalForm` 'NON_PROFIT_ORGANIZATION' | 'ASSOCIATION_UNDER_LOCAL_LAW' | 'FREE_TRADE_ASSOCIATION' | 'CHURCH_CHARITY_CONGREGATION' — Legal form of the entity (e.g., SAS, SARL)
    - `taxCode` string
    - `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
    - `activity` AssociationActivity — Activity and business scope details
      - `NACEcode` '1.11' | '1.12' | '1.13' | '1.14' | '1.15' | '1.16' | '1.19' | '1.21' | '1.22' | '1.23' | '1.24' | '1.25' | '1.26' | '1.27' | '1.28' | '1.29' | '1.3' | '1.41' | '1.42' | '1.43' | '1.44' | '1.45' | '1.46' | '1.47' | '1.49' | '1.5' | '1.61' | '1.62' | '1.63' | '1.64' | '1.7' | '2.1' | '2.2' | '2.3' | '2.4' | '3.11' | '3.12' | '3.21' | '3.22' | '5.1' | '5.2' | '6.1' | '6.2' | '7.1' | '7.21' | '7.29' | '8.11' | '8.12' | '8.91' | '8.92' | '8.93' | '8.99' | '9.1' | '9.9' | '10.11' | '10.12' | '10.13' | '10.2' | '10.31' | '10.32' | '10.39' | '10.41' | '10.42' | '10.51' | '10.52' | '10.61' | '10.62' | '10.71' | '10.72' | '10.73' | '10.81' | '10.82' | '10.83' | '10.84' | '10.85' | '10.86' | '10.89' | '10.91' | '10.92' | '11.01' | '11.02' | '11.03' | '11.04' | '11.05' | '11.06' | '11.07' | '12' | '13.1' | '13.2' | '13.3' | '13.91' | '13.92' | '13.93' | '13.94' | '13.95' | '13.96' | '13.99' | '14.11' | '14.12' | '14.13' | '14.14' | '14.19' | '14.2' | '14.31' | '14.39' | '15.11' | '15.12' | '15.2' | '16.1' | '16.21' | '16.22' | '16.23' | '16.24' | '16.29' | '17.11' | '17.12' | '17.21' | '17.22' | '17.23' | '17.24' | '17.29' | '18.11' | '18.12' | '18.13' | '18.14' | '18.2' | '19.1' | '19.2' | '20.11' | '20.12' | '20.13' | '20.14' | '20.15' | '20.16' | '20.17' | '20.2' | '20.3' | '20.41' | '20.42' | '20.51' | '20.52' | '20.53' | '20.59' | '20.6' | '21.1' | '21.2' | '22.11' | '22.19' | '22.21' | '22.22' | '22.23' | '22.29' | '23.11' | '23.12' | '23.13' | '23.14' | '23.19' | '23.2' | '23.31' | '23.32' | '23.41' | '23.42' | '23.43' | '23.44' | '23.49' | '23.51' | '23.52' | '23.61' | '23.62' | '23.63' | '23.64' | '23.65' | '23.69' | '23.7' | '23.91' | '23.99' | '24.1' | '24.2' | '24.31' | '24.32' | '24.33' | '24.34' | '24.41' | '24.42' | '24.43' | '24.44' | '24.45' | '24.46' | '24.51' | '24.52' | '24.53' | '24.54' | '25.11' | '25.12' | '25.21' | '25.29' | '25.3' | '25.4' | '25.5' | '25.61' | '25.62' | '25.71' | '25.72' | '25.73' | '25.91' | '25.92' | '25.93' | '25.94' | '25.99' | '26.11' | '26.12' | '26.2' | '26.3' | '26.4' | '26.51' | '26.52' | '26.6' | '26.7' | '26.8' | '27.11' | '27.12' | '27.2' | '27.31' | '27.32' | '27.33' | '27.4' | '27.51' | '27.52' | '27.9' | '28.11' | '28.12' | '28.13' | '28.14' | '28.15' | '28.21' | '28.22' | '28.23' | '28.24' | '28.25' | '28.29' | '28.3' | '28.41' | '28.49' | '28.91' | '28.92' | '28.93' | '28.94' | '28.95' | '28.96' | '28.99' | '29.1' | '29.2' | '29.31' | '29.32' | '30.11' | '30.12' | '30.2' | '30.3' | '30.4' | '30.91' | '30.92' | '30.99' | '31.01' | '31.02' | '31.03' | '31.09' | '32.11' | '32.12' | '32.13' | '32.2' | '32.3' | '32.4' | '32.5' | '32.91' | '32.99' | '33.11' | '33.12' | '33.13' | '33.14' | '33.15' | '33.16' | '33.17' | '33.19' | '33.2' | '35.11' | '35.12' | '35.13' | '35.14' | '35.21' | '35.22' | '35.23' | '35.3' | '36' | '37' | '38.11' | '38.12' | '38.21' | '38.22' | '38.31' | '38.32' | '39' | '41.1' | '41.2' | '42.11' | '42.12' | '42.13' | '42.21' | '42.22' | '42.91' | '42.99' | '43.11' | '43.12' | '43.13' | '43.21' | '43.22' | '43.29' | '43.31' | '43.32' | '43.33' | '43.34' | '43.39' | '43.91' | '43.99' | '45.11' | '45.19' | '45.2' | '45.31' | '45.32' | '45.4' | '46.11' | '46.12' | '46.13' | '46.14' | '46.15' | '46.16' | '46.17' | '46.18' | '46.19' | '46.21' | '46.22' | '46.23' | '46.24' | '46.31' | '46.32' | '46.33' | '46.34' | '46.35' | '46.36' | '46.37' | '46.38' | '46.39' | '46.41' | '46.42' | '46.43' | '46.44' | '46.45' | '46.46' | '46.47' | '46.48' | '46.49' | '46.51' | '46.52' | '46.61' | '46.62' | '46.63' | '46.64' | '46.65' | '46.66' | '46.69' | '46.71' | '46.72' | '46.73' | '46.74' | '46.75' | '46.76' | '46.77' | '46.9' | '47.11' | '47.19' | '47.21' | '47.22' | '47.23' | '47.24' | '47.25' | '47.26' | '47.29' | '47.3' | '47.41' | '47.42' | '47.43' | '47.51' | '47.52' | '47.53' | '47.54' | '47.59' | '47.61' | '47.62' | '47.63' | '47.64' | '47.65' | '47.71' | '47.72' | '47.73' | '47.74' | '47.75' | '47.76' | '47.77' | '47.78' | '47.79' | '47.81' | '47.82' | '47.89' | '47.91' | '47.99' | '49.1' | '49.2' | '49.31' | '49.32' | '49.39' | '49.41' | '49.42' | '49.5' | '50.1' | '50.2' | '50.3' | '50.4' | '51.1' | '51.21' | '51.22' | '52.1' | '52.21' | '52.22' | '52.23' | '52.24' | '52.29' | '53.1' | '53.2' | '55.1' | '55.2' | '55.3' | '55.9' | '56.1' | '56.21' | '56.29' | '56.3' | '58.11' | '58.12' | '58.13' | '58.14' | '58.19' | '58.21' | '58.29' | '59.11' | '59.12' | '59.13' | '59.14' | '59.2' | '60.1' | '60.2' | '61.1' | '61.2' | '61.3' | '61.9' | '62.01' | '62.02' | '62.03' | '62.09' | '63.11' | '63.12' | '63.9' | '63.91' | '63.99' | '64' | '64.11' | '64.19' | '64.2' | '64.3' | '64.9' | '64.91' | '64.92' | '64.99' | '65.11' | '65.12' | '65.2' | '65.3' | '66.11' | '66.12' | '66.19' | '66.21' | '66.22' | '66.3' | '68.1' | '68.2' | '68.31' | '68.32' | '69.1' | '69.2' | '70.1' | '70.21' | '70.22' | '71.11' | '71.12' | '71.2' | '72.11' | '72.19' | '72.2' | '73.11' | '73.12' | '73.2' | '74.1' | '74.2' | '74.3' | '74.9' | '77.11' | '77.12' | '77.21' | '77.22' | '77.29' | '77.31' | '77.32' | '77.33' | '77.34' | '77.35' | '77.39' | '77.4' | '78.1' | '78.2' | '78.3' | '79.1' | '79.11' | '79.12' | '79.9' | '80' | '80.1' | '80.2' | '80.3' | '81' | '81.1' | '81.2' | '81.21' | '81.22' | '81.29' | '81.3' | '82.1' | '82.11' | '82.19' | '82.2' | '82.3' | '82.91' | '82.92' | '82.99' | '84.11' | '84.12' | '84.13' | '84.21' | '84.22' | '84.23' | '84.24' | '84.25' | '84.3' | '85.1' | '85.2' | '85.31' | '85.32' | '85.51' | '85.52' | '85.53' | '85.59' | '85.6' | '86.1' | '86.21' | '86.22' | '86.23' | '86.9' | '87.1' | '87.2' | '87.3' | '87.9' | '88.1' | '88.91' | '88.99' | '90.01' | '90.02' | '90.03' | '90.04' | '91.01' | '91.02' | '91.03' | '91.04' | '92' | '93.11' | '93.12' | '93.13' | '93.19' | '93.21' | '93.29' | '94.11' | '94.12' | '94.2' | '94.91' | '94.92' | '94.99' | '95.11' | '95.12' | '95.21' | '95.22' | '95.23' | '95.24' | '95.25' | '95.29' | '96.01' | '96.02' | '96.03' | '96.04' | '96.09' | '97' | '98.1' | '98.2' | '99' — NACEcode
      - `ATECOcode` '011' | '012' | '013' | '014' | '015' | '016' | '017' | '021' | '022' | '023' | '024' | '031' | '032' | '051' | '052' | '061' | '062' | '071' | '072' | '081' | '089' | '091' | '099' | '101' | '102' | '103' | '104' | '105' | '106' | '107' | '108' | '109' | '110' | '120' | '131' | '132' | '133' | '139' | '141' | '142' | '143' | '151' | '152' | '161' | '162' | '171' | '172' | '181' | '182' | '191' | '192' | '201' | '202' | '203' | '204' | '205' | '206' | '211' | '212' | '221' | '222' | '231' | '232' | '233' | '234' | '235' | '236' | '237' | '239' | '241' | '242' | '243' | '244' | '245' | '251' | '252' | '253' | '254' | '255' | '256' | '257' | '259' | '261' | '262' | '263' | '264' | '265' | '266' | '267' | '268' | '271' | '272' | '273' | '274' | '275' | '279' | '281' | '282' | '283' | '284' | '289' | '291' | '292' | '293' | '301' | '302' | '303' | '304' | '309' | '310' | '321' | '322' | '323' | '324' | '325' | '329' | '331' | '332' | '351' | '352' | '353' | '360' | '370' | '381' | '382' | '383' | '390' | '411' | '412' | '421' | '422' | '429' | '431' | '432' | '433' | '439' | '451' | '452' | '453' | '454' | '461' | '462' | '463' | '464' | '465' | '466' | '467' | '469' | '471' | '472' | '473' | '474' | '475' | '476' | '477' | '478' | '479' | '491' | '492' | '493' | '494' | '495' | '501' | '502' | '503' | '504' | '511' | '512' | '521' | '522' | '531' | '532' | '551' | '552' | '553' | '559' | '561' | '562' | '563' | '581' | '582' | '591' | '592' | '601' | '602' | '611' | '612' | '613' | '619' | '620' | '631' | '639' | '641' | '642' | '643' | '649' | '651' | '652' | '653' | '661' | '662' | '663' | '681' | '682' | '683' | '691' | '692' | '701' | '702' | '711' | '712' | '721' | '722' | '731' | '732' | '741' | '742' | '743' | '749' | '750' | '771' | '772' | '773' | '774' | '781' | '782' | '783' | '791' | '799' | '801' | '802' | '803' | '811' | '812' | '813' | '821' | '822' | '823' | '829' | '841' | '842' | '843' | '851' | '852' | '853' | '854' | '855' | '856' | '861' | '862' | '869' | '871' | '872' | '873' | '879' | '881' | '889' | '900' | '910' | '920' | '931' | '932' | '941' | '942' | '949' | '951' | '952' | '960' | '970' | '981' | '982' | '990' — ATECOcode
      - `description` string
      - `fundsDestinationCountries` FundsDestinationCountries
        - `sameFundCountryAsCompanyRegistration` boolean, required
        - `otherFundsDestinationCountries` OtherFundsDestinationCountries
          - `countries` string[], required
          - `reason` string, required
      - `location` Location
        - `sameAddressAsCompanyRegistration` boolean, required
        - `address` OnboardingAddress — 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
      - `entitiesFinancing` EntityFinancing[]
        - `by` 'DONATION' | 'MEMBERSHIP_FEES' | 'SUBVENTION' | 'OTHER' — FinancingType
        - `other` string
    - `project` LegalEntityProject — Project-related details
      - `description` string
      - `website` string
    - `financialSituation` LegalEntityFinancialSituation — Financial situation details
      - `expectedActivityVolume` 'FIRST_TIER' | 'SECOND_TIER' | 'THIRD_TIER' | 'FOURTH_TIER' | 'FIFTH_TIER' | 'SIXTH_TIER' | 'SEVENTH_TIER' — ActivityVolume
      - `currentTurnover` 'FIRST_TIER' | 'SECOND_TIER' | 'THIRD_TIER' | 'FOURTH_TIER' | 'FIFTH_TIER' | 'SIXTH_TIER' | 'SEVENTH_TIER' — TurnoverRange
      - `previousTurnover` 'FIRST_TIER' | 'SECOND_TIER' | 'THIRD_TIER' | 'FOURTH_TIER' | 'FIFTH_TIER' | 'SIXTH_TIER' | 'SEVENTH_TIER' — TurnoverRange
      - `financialAsset` 'FIRST_TIER' | 'SECOND_TIER' | 'THIRD_TIER' | 'FOURTH_TIER' | 'FIFTH_TIER' | 'SIXTH_TIER' | 'SEVENTH_TIER' — FinancialAsset
  - `legalRepresentative` AssociationLegalRepresentative, required — Legal representative details (see nested bodyParams below)
    - `firstName` string, required — First name of the legal representative
    - `lastName` string, required — Last name of the legal representative
    - `otherName` string
    - `birthDate` string, required — Date of birth (ISO 8601 format)
    - `birthCity` string
    - `birthCountry` string, required — Country of birth (ISO 2-letter code)
    - `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 — List of nationality codes (ISO 2-letter)
    - `email` string, required — Email address of the representative
    - `phoneNumber` string — Phone number of the representative
    - `taxCode` string
    - `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
    - `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
    - `positions` string[]

## 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)