Sign in

v1

latestOpenAPI 3.0.12026-07-24128351404.9 KB
Account Onboarding

Create Legal Entity

Creates a new legal entity for business onboarding. The request should include company information, legal representative details, and supporting KYC documents. A unique entity ID will be returned upon successful submission.

post/open-api/v3/business/account/{accountId}/legal-entity

Path parameters

accountIdstring required

Request body

OR

Example request

{
  "personType": "COMPANY",
  "businessInfo": {
    "phonePrefix": "+1",
    "phone": "1234567890",
    "registrationDate": "2020-01-01",
    "taxNumber": "123-45-6789",
    "industry": "Technology",
    "businessNumber": "Tech Solutions Inc.",
    "attachmentLicense": {
      "fileId": "6b4ed6df-fb42-4f7c-a9e2-f35f99056a90"
    },
    "attachmentAddress": {
      "fileId": "6b4ed6df-fb42-4f7c-a9e2-f35f99056a90"
    },
    "registrationAddress": {
      "addressLine1": "123 Main St",
      "addressLine2": "Apt 4B",
      "city": "New York",
      "country": "US",
      "postalCode": "10001"
    },
    "businessNameEn": "Tech Solutions Inc.",
    "email": "xxx@.com",
    "attachmentCorporateRecords": {
      "fileId": "6b4ed6df-fb42-4f7c-a9e2-f35f99056a90"
    },
    "attachmentCorporateResolution": {
      "fileId": "6b4ed6df-fb42-4f7c-a9e2-f35f99056a90"
    },
    "attachmentFiscalCertificate": {
      "fileId": "6b4ed6df-fb42-4f7c-a9e2-f35f99056a90"
    },
    "attachmentFatca": {
      "fileId": "6b4ed6df-fb42-4f7c-a9e2-f35f99056a90"
    },
    "attachmentFinancialStatements": {
      "fileId": "6b4ed6df-fb42-4f7c-a9e2-f35f99056a90"
    },
    "attachmentRegistrationNumber": {
      "fileId": "6b4ed6df-fb42-4f7c-a9e2-f35f99056a90"
    },
    "attachmentSourceOfFunds": {
      "fileId": "6b4ed6df-fb42-4f7c-a9e2-f35f99056a90"
    },
    "attachmentTaxIdNumber": {
      "fileId": "6b4ed6df-fb42-4f7c-a9e2-f35f99056a90"
    }
  },
  "shareholders": [
    {
      "personInfo": {
        "birthday": "US",
        "firstName": "John",
        "lastName": "Doe",
        "address": {
          "addressLine1": "123 Main St",
          "addressLine2": "Apt 4B",
          "city": "New York",
          "country": "US",
          "postalCode": "10001"
        },
        "gender": "MALE",
        "identityType": "PASSPORT",
        "attachmentAddress": {
          "fileId": "6b4ed6df-fb42-4f7c-a9e2-f35f99056a90"
        },
        "region": "CA",
        "idNo": "123456789",
        "attachmentIdentity": {
          "fileId": "6b4ed6df-fb42-4f7c-a9e2-f35f99056a90"
        },
        "attachmentFatca": {
          "fileId": "6b4ed6df-fb42-4f7c-a9e2-f35f99056a90"
        },
        "attachmentSourceOfFunds": {
          "fileId": "6b4ed6df-fb42-4f7c-a9e2-f35f99056a90"
        }
      },
      "ratio": "0.5"
    }
  ],
  "personInfo": {
    "birthday": "US",
    "firstName": "John",
    "lastName": "Doe",
    "address": {
      "addressLine1": "123 Main St",
      "addressLine2": "Apt 4B",
      "city": "New York",
      "country": "US",
      "postalCode": "10001"
    },
    "gender": "MALE",
    "identityType": "PASSPORT",
    "attachmentAddress": {
      "fileId": "6b4ed6df-fb42-4f7c-a9e2-f35f99056a90"
    },
    "region": "CA",
    "idNo": "123456789",
    "attachmentIdentity": {
      "fileId": "6b4ed6df-fb42-4f7c-a9e2-f35f99056a90"
    },
    "attachmentFatca": {
      "fileId": "6b4ed6df-fb42-4f7c-a9e2-f35f99056a90"
    },
    "attachmentSourceOfFunds": {
      "fileId": "6b4ed6df-fb42-4f7c-a9e2-f35f99056a90"
    }
  }
}

Response

success

codestring

Business code, 000000 means success

messagestring

Message description

Example response

{
  "code": "000000",
  "message": "success",
  "data": {
    "parentAccountId": "dddaef0d-265f-484f-9b42-60175aa6f80e",
    "accountId": "123e4567-e89b-12d3-a456-426614174000",
    "accountName": "My Business Account",
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "status": "PENDING"
  }
}