--- title: "Update Legal Entity" method: PUT path: "/open-api/v3/business/account/{accountId}/legal-entity/{id}" tags: ["Account Onboarding"] --- # Update Legal Entity `PUT /open-api/v3/business/account/{accountId}/legal-entity/{id}` ## Request - Base URL: `https://api-sandbox.interlace.money` - URL: `https://api-sandbox.interlace.money/open-api/v3/business/account/{accountId}/legal-entity/{id}` - Auth: API key in header `x-access-token` Updates information for a specific legal entity using its unique ID. ## Path parameters - `accountId` string, required - `id` string, required ## Request body - union - CompanyInfoDetail - `personType` 'COMPANY', required: Person Type - `businessInfo` BusinessInfo, required: Business Information - `phonePrefix` string, required: Mobile Number Prefix - `website` string: Website - `phone` string, required: Mobile Number - `registrationDate` string, required: Registration Date - `taxNumber` string, required: Tax Number - `industry` string, required: 6-digit NAICS code ([**NAICS_code**](https://qbit-develop.oss-accelerate.aliyuncs.com/global-account/b8c8ea84-92c6-4dd5-9db1-9f121f527e37/1760523281354/NAICS.xlsx)) - `businessNumber` string, required: Business Number - `attachmentLicense` AttachmentLicense, required: Certificate of Company License(pdf/jpeg/png, limit 8M) - `fileId` string, required: File Id - `attachmentAddress` AttachmentPoa, required: Proof of Address - `fileId` string, required: File Id - `registrationAddress` Address, required: The bank address. - `addressLine1` string, required: Primary address line (Street address / PO Box / Company name). English letters only, numbers and common symbols allowed. - `addressLine2` string: Secondary address line (Apartment / Suite / Unit / Building). English letters only, numbers and common symbols allowed. - `city` string, required: City. English letters and spaces only. - `state` string, required: **State / County / Province / Region**: Required for all countries. - For the US and Canada: must provide the subdivision using the two-letter code (e.g., WA for Washington State). - For other countries without a state/province, repeat the country name. - Allowed characters: English letters, numbers, and common symbols. - `country` string, required: Two-letter country code, as defined in ISO 3166-1 alpha-2. Example: US - `postalCode` string, required: Postal / ZIP code of the address. - `businessNameEn` string, required: Business Name in English - `email` string, required: email - `attachmentCorporateRecords` AttachmentCorporateRecord, required: Articles of Association or Memorandum of Association(pdf/jpeg/png, limit 8M) - `fileId` string, required: File Id - `attachmentCorporateResolution` AttachmentCorporateResolution, required: Company/Corporate Resolution(pdf/jpeg/png, limit 8M) - `fileId` string, required: File Id - `attachmentFiscalCertificate` AttachmentFiscalCertificate, required: Company Fiscal Registration Certificate(pdf/jpeg/png, limit 8M) - `fileId` string, required: File Id - `attachmentFatca` AttachmentFatca, required: FATCA – W8Ben or W9 Filing(pdf/jpeg/png, limit 8M) - `fileId` string, required: File Id - `attachmentFinancialStatements` AttachmentFinancialStatement, required: Financial Statements(pdf/jpeg/png, limit 8M) - `fileId` string, required: File Id - `attachmentRegistrationNumber` AttachmentRegistrationNumber, required: Government Issued Certificate of Company Registration Number(pdf/jpeg/png, limit 8M) - `fileId` string, required: File Id - `attachmentSourceOfFunds` AttachmentPof, required: Source of Funds Certification(pdf/jpeg/png, limit 8M) - `fileId` string, required: File Id - `attachmentTaxIdNumber` AttachmentTaxIdNumber, required: Tax Identification Number or Equivalent(pdf/jpeg/png, limit 8M) - `fileId` string, required: File Id - `shareholders` ShareholdersItem[], required: Shareholder Information List - `personInfo` PersonInfo, required: Personal Information - `birthday` string, required: yyyy-MM-dd - `firstName` string, required: First Name - `lastName` string, required: Last Name - `address` Address, required: The bank address. - `addressLine1` string, required: Primary address line (Street address / PO Box / Company name). English letters only, numbers and common symbols allowed. - `addressLine2` string: Secondary address line (Apartment / Suite / Unit / Building). English letters only, numbers and common symbols allowed. - `city` string, required: City. English letters and spaces only. - `state` string, required: **State / County / Province / Region**: Required for all countries. - For the US and Canada: must provide the subdivision using the two-letter code (e.g., WA for Washington State). - For other countries without a state/province, repeat the country name. - Allowed characters: English letters, numbers, and common symbols. - `country` string, required: Two-letter country code, as defined in ISO 3166-1 alpha-2. Example: US - `postalCode` string, required: Postal / ZIP code of the address. - `gender` 'MALE' | 'FEMALE', required: Gender. - `identityType` 'CN-RIC' | 'PASSPORT', required: Identity Type - `attachmentAddress` AttachmentPoa, required: Proof of Address - `fileId` string, required: File Id - `region` string, required: Region - `idNo` string, required: ID Number - `identityExpiryDate` string, required: Identification expiry date - `taxIdNumber` string: SSN/ITIN, Mandatory for US citizenship or US residents - `attachmentIdentity` AttachmentIdentity, required: Certificate of Identification(pdf/jpeg/png, limit 8M) - `fileId` string, required: File Id - `attachmentFatca` AttachmentFatca, required: FATCA – W8Ben or W9 Filing(pdf/jpeg/png, limit 8M) - `fileId` string, required: File Id - `attachmentSourceOfFunds` AttachmentPof, required: Source of Funds Certification(pdf/jpeg/png, limit 8M) - `fileId` string, required: File Id - `ratio` string, required: Shareholder Percentage - `personInfo` PersonInfo, required: Personal Information - `birthday` string, required: yyyy-MM-dd - `firstName` string, required: First Name - `lastName` string, required: Last Name - `address` Address, required: The bank address. - `addressLine1` string, required: Primary address line (Street address / PO Box / Company name). English letters only, numbers and common symbols allowed. - `addressLine2` string: Secondary address line (Apartment / Suite / Unit / Building). English letters only, numbers and common symbols allowed. - `city` string, required: City. English letters and spaces only. - `state` string, required: **State / County / Province / Region**: Required for all countries. - For the US and Canada: must provide the subdivision using the two-letter code (e.g., WA for Washington State). - For other countries without a state/province, repeat the country name. - Allowed characters: English letters, numbers, and common symbols. - `country` string, required: Two-letter country code, as defined in ISO 3166-1 alpha-2. Example: US - `postalCode` string, required: Postal / ZIP code of the address. - `gender` 'MALE' | 'FEMALE', required: Gender. - `identityType` 'CN-RIC' | 'PASSPORT', required: Identity Type - `attachmentAddress` AttachmentPoa, required: Proof of Address - `fileId` string, required: File Id - `region` string, required: Region - `idNo` string, required: ID Number - `identityExpiryDate` string, required: Identification expiry date - `taxIdNumber` string: SSN/ITIN, Mandatory for US citizenship or US residents - `attachmentIdentity` AttachmentIdentity, required: Certificate of Identification(pdf/jpeg/png, limit 8M) - `fileId` string, required: File Id - `attachmentFatca` AttachmentFatca, required: FATCA – W8Ben or W9 Filing(pdf/jpeg/png, limit 8M) - `fileId` string, required: File Id - `attachmentSourceOfFunds` AttachmentPof, required: Source of Funds Certification(pdf/jpeg/png, limit 8M) - `fileId` string, required: File Id - PersonInfoDetail - `personType` 'INDIVIDUAL', required: Person Type - `personInfo` PersonInfo, required: Personal Information - `birthday` string, required: yyyy-MM-dd - `firstName` string, required: First Name - `lastName` string, required: Last Name - `address` Address, required: The bank address. - `addressLine1` string, required: Primary address line (Street address / PO Box / Company name). English letters only, numbers and common symbols allowed. - `addressLine2` string: Secondary address line (Apartment / Suite / Unit / Building). English letters only, numbers and common symbols allowed. - `city` string, required: City. English letters and spaces only. - `state` string, required: **State / County / Province / Region**: Required for all countries. - For the US and Canada: must provide the subdivision using the two-letter code (e.g., WA for Washington State). - For other countries without a state/province, repeat the country name. - Allowed characters: English letters, numbers, and common symbols. - `country` string, required: Two-letter country code, as defined in ISO 3166-1 alpha-2. Example: US - `postalCode` string, required: Postal / ZIP code of the address. - `gender` 'MALE' | 'FEMALE', required: Gender. - `identityType` 'CN-RIC' | 'PASSPORT', required: Identity Type - `attachmentAddress` AttachmentPoa, required: Proof of Address - `fileId` string, required: File Id - `region` string, required: Region - `idNo` string, required: ID Number - `identityExpiryDate` string, required: Identification expiry date - `taxIdNumber` string: SSN/ITIN, Mandatory for US citizenship or US residents - `attachmentIdentity` AttachmentIdentity, required: Certificate of Identification(pdf/jpeg/png, limit 8M) - `fileId` string, required: File Id - `attachmentFatca` AttachmentFatca, required: FATCA – W8Ben or W9 Filing(pdf/jpeg/png, limit 8M) - `fileId` string, required: File Id - `attachmentSourceOfFunds` AttachmentPof, required: Source of Funds Certification(pdf/jpeg/png, limit 8M) - `fileId` string, required: File Id ## Response `200` success - ApiResultUpdateLegalEntitiesRespDTO - `code` string: Business code, 000000 means success - `message` string: Message description - `data` CreateLegalEntitiesRespDTO: Response data, null if error - `parentAccountId` string: The parent account ID of the specified account. - `accountId` string: The UUID of the Account. - `accountName` string: Account Name - `id` string: Unique ID generated for the entity. - `idNumber` string: IdNo / Business Number etc. - `createTime` string: create time, millisecond timestamp - `status` 'PENDING' | 'PROCESSING' | 'AWAIT_ADDITIONAL' | 'REVIEW_ADDITIONAL' | 'REQUEST' | 'FROZEN' | 'FAILED' | 'DELETED' | 'INACTIVE' | 'ACTIVE': Status of the legal entity onboarding process: - **PENDING** — The application has been submitted and is awaiting processing. - **PROCESSING** — The application is under review or verification. - **AWAIT_ADDITIONAL** — Additional information or documents are required from the applicant. - **REVIEW_ADDITIONAL** — The additional documents submitted are being reviewed. - **REQUEST** — The entity has requested activation or modification. - **FROZEN** — The account or entity has been temporarily frozen due to compliance or risk reasons. - **FAILED** — The onboarding or verification process failed. - **DELETED** — The entity record has been deleted or permanently deactivated. - **INACTIVE** — The entity or account exists but is not yet active. - **ACTIVE** — The entity or account is fully active and operational. ## Other responses - `400`: Bad Request --- [API](https://skmtc.dev/interlace/apis/business-account.md) - [All operations](https://skmtc.dev/interlace/apis/business-account/llms.txt) - [OpenAPI document](https://skmtc.dev/interlace/apis/business-account/revisions/dd6b30aaac4f?raw)