LElemonway
accounts

Create Corporate Account with Legal Representative

Changed on

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)

post/accounts/legal-entity

Request

  • Base URL
    https://onboarding-api.lemonway.com
  • URL
    https://onboarding-api.lemonway.com/accounts/legal-entity
  • Auth
    HTTP bearer

Request body

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)

profile'DONOR' | 'PROJECT_HOLDER' | 'LENDER' | 'INVESTOR' | 'CREDITOR' | 'DEBTOR' | 'BUYER' | 'MERCHANT' | 'SELLER' | 'OPERATOR' | 'CONTENT_EDITOR' | 'OTHER_OPERATOR' | 'VISA_APPLICANT' | 'PAYER' required

User profile type

walletIdstring

Wallet identifier

Example request

{
  "activity": "CROWDFUNDING_MONEYPOT",
  "legalEntity": {
    "name": "Matt Claxton",
    "type": "ClaxtonBells",
    "registrationNumber": "126766Z",
    "registrationDate": "2025-08-11T08:10:18.405Z",
    "address": {
      "country": "UK"
    }
  },
  "legalRepresentative": {
    "firstName": "Diane",
    "lastName": "Bethney",
    "birthDate": "2025-08-11T08:10:18.405Z",
    "birthCountry": "UK",
    "email": "BethneyD12@gmail.com",
    "address": {
      "country": "UK"
    }
  },
  "profile": "DONOR",
  "walletId": "1278782"
}

Response

Account created successfully

idstring 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

Example response

{
  "id": "ff928147-d51e-4f22-b26c-d2c1a2sebd8d",
  "status": "CREATED",
  "profileStatus": "AWAITING_INFORMATION"
}

Changes

  • cd81a3b18d83Revision changes
    • breaking

      the request property // became required

    • breaking

      the request property // became required

    • warning

      removed the request property //

    • warning

      removed the request property //

    • warning

      removed the request property //

    • warning

      removed the request property //

    • warning

      removed the request property //

    • warning

      removed the request property //

    • info

      the // request property's minLength was decreased from 3 to 0

    • info

      the // request property's minLength was decreased from 3 to 0