Skip to main content
PATCH
Update a business entity
Partially update a reusable Commenda OS business entity. Use this endpoint to complete corporate shareholder details before registering the business entity as an incorporation participant, or before re-running incorporation validation after Commenda requests corrections.

Authorizations

x-api-key
string
header
required

Path Parameters

customerId
integer
required

Commenda customer identifier.

businessEntityId
integer
required

Commenda business-entity identifier for the specified customer.

Body

application/json

Partially update a reusable Commenda OS business entity. Omitted fields are left unchanged.

Required string length: 1 - 1024
Example:

"Acme Holdings Pte. Ltd."

dbaName
string
Required string length: 1 - 1024
Example:

"Acme"

businessCode
string
Maximum string length: 128
Example:

"64202"

businessDescription
string
Maximum string length: 4096
Example:

"Investment holding company."

dateOfClosure
string<date-time>

ISO 8601 closure date.

Example:

"2026-03-01T00:00:00.000Z"

accountingBasis
string
Example:

"CASH"

taxedAs
string
Example:

"CORPORATION"

bookkeepingFrequency
string | null
Example:

"MONTHLY"

nonUSBusinessEntityEIN
string

Temporary non-US EIN handling field.

Example:

"12-3456789"

requestedEIN
boolean

Temporary non-US EIN handling field.

Example:

false

publicFacingWebsiteUrl
string<uri>
Example:

"https://acme.example"

fiscalYearDay
integer
Required range: 1 <= x <= 31
Example:

31

fiscalYearMonth
integer
Required range: 1 <= x <= 12
Example:

12

naicsCode
string

NAICS business code.

Example:

"551112"

isIncorporationInProgress
boolean
Example:

false

countrySpecificFields
object

Country-specific update payloads supported by the underlying Commenda OS business entity API.

Response

Business entity updated successfully

businessEntity
object
required