---
title: "POST /accounts/legal-entity"
method: POST
path: "/accounts/legal-entity"
tags: ["accounts"]
---

# POST /accounts/legal-entity

`POST /accounts/legal-entity`

Creates a new legal entity account by providing the entity’s details along with information about its legal representative. This request is typically the first step before initiating the onboarding process. Once created, the account will have an initial status (e.g., CREATED) and a profile status (e.g., AWAITING_INFORMATION)

## Request body

- CreateLegalEntityAccountRequest
  - `activity` 'CROWDFUNDING_MONEYPOT' | 'CROWDFUNDING_DONATION' | 'MARKETPLACE_B2B' | 'MARKETPLACE_B2C' | 'MARKETPLACE_C2C' | 'CROWDEQUITY' | 'CROWDLENDING' | 'VALUE_ADDED_SERVICE' | 'INVOICE_TRADING' | 'MARKETPLACE_B2C_C2C' | 'VISA_ACCOUNT_APPLICATION' | 'SALARY_ADVANCE' — Activity code or category for the legal entity (e.g., type of business)
  - `legalEntity` LegalEntity, required — Details about the legal entity (see nested bodyParams)
    - `name` string, required — Full legal name of the entity.
    - `type` 'COMPANY' | 'ASSOCIATION' | 'SOLE_TRADER', required — Legal form/type of the entity.
    - `registrationNumber` string — Official company registration number
    - `registrationDate` string, date-time, required — Date of legal registration (ISO 8601 format)
    - `address` Address
      - `street` string — Client number and street
      - `postCode` string — Client Postcode/ZIP
      - `city` string — Client city
      - `country` string — Client country using ISO 3166-1 alpha-3
  - `legalRepresentative` LegalRepresentative, required — Information about the entity’s legal representative (see nested bodyParams).
    - `firstName` string, required — Representative’s first name
    - `lastName` string, required — Representative’s last name
    - `birthDate` string, date-time, required — Date of birth (ISO 8601 format)
    - `birthCountry` string, required — Country of birth (ISO 2-letter code)
    - `nationalities` string[], required — List of nationality codes (ISO 2-letter)
    - `email` string, required — Email address of the legal representative
    - `address` Address, required
      - `street` string — Client number and street
      - `postCode` string — Client Postcode/ZIP
      - `city` string — Client city
      - `country` string — Client country using ISO 3166-1 alpha-3
  - `profile` 'DONOR' | 'PROJECT_HOLDER' | 'LENDER' | 'INVESTOR' | 'CREDITOR' | 'DEBTOR' | 'BUYER' | 'MERCHANT' | 'SELLER' | 'OPERATOR' | 'CONTENT_EDITOR' | 'OTHER_OPERATOR' | 'VISA_APPLICANT' | 'PAYER', required — User profile type
  - `walletId` string — Wallet identifier

## Response `201`

Account created successfully

- CreateAccountResponse
  - `id` string, required
  - `status` 'ACCEPTED' | 'CREATED' | 'DENIED' | 'BLOCKED', required
  - `profileStatus` 'ACCEPTED' | 'AWAITING_INFORMATION' | 'CREATION_IN_PROGRESS' | 'DENIED' | 'IDENTITY_VERIFICATION_IN_PROGRESS' | 'IDENTITY_VERIFICATION_ABANDONED' | 'IDENTITY_VERIFICATION_ERROR' | 'INFORMATION_COLLECTION_IN_PROGRESS' | 'REJECTED' | 'UNDER_ANALYSIS', required

## Other responses

- `400` — Missing or invalid request parameters
- `401` — Missing or invalid authentication token
- `409` — Account with similar details already exists
- `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)