IdentityEntity

Update a business entity

Update an existing business entity.

patch/entities/business/{entity_id}

Request

  • Base URL: https://api.column.com
  • URL: https://api.column.com/entities/business/{entity_id}
  • Auth: HTTP basic

Path parameters

entity_idstring required

Request body

account_usagestring[]

Indicates possible uses of the accounts an entity may use at Column. Only required for a root entity.

business_namestring

Legal Business Name

collected_atobject

Field collection timestamps, keyed by field path (for example, business_name or ein). Values must be RFC3339 timestamps between 1900-01-01T00:00:00Z and the current time. PATCH merges keys into the existing map; an empty map preserves existing timestamps. Nested beneficial owner fields do not support collected_at; attest beneficial owners separately as person entities.

countries_of_operationstring[]

Countries in which the business currently operates or expects to operate. Only ISO 3166-1 Alpha-2 Country Codes (e.g., US, FR, UK, DE, ... ) are allowed. Only required for a root entity.

country_of_incorporationstring

Country in which the business is incorporated. ISO 3166-1 Alpha-2 Country Code.

date_of_incorporationstring

Date on which the business was incorporated. Format: YYYY-MM-DD.

dba_namestring

Doing Business As name, if different from the legal business name.

descriptionstring

Description of the business entity. Only required for a root entity.

einstring

Employer Identification Number (Tax ID). This may be SSN for a sole proprietorship.

end_customer_typestring

Type of end customer the business serves. Accepts a free-form string.

expected_payment_railsstring

Expected transaction types for the account. Comma-separated list of payment rails; each value must be one of: ach, wire, swift, check, rtp, card_spend.

expected_use_of_fundsstring

Expected use of funds for the business accounts. Accepts a free-form string.

has_virtual_addressboolean

Indicates whether the business uses a virtual address.

industrystring

Industry in which the business entity operates.

is_high_riskboolean

Indicates whether the entity has been identified as high risk based on compliance screening

legal_typestring

Type of business. Permitted values are limited-partnership, trust, sole-proprietorship, corporation, llc, general-partnership, professional-association, government, non-profit, other, pic-piv, spv, irrevocable_trust, revocable_trust.

makes_international_paymentsboolean

Indicates whether the business expects to make international payments.

payment_volumesstring

Expected payment volumes. Only required for a root entity.

purpose_of_accountstring

Intended use of the account.

registration_idobject

Registration ID. EIN or Registration ID is required.

source_of_fundsstring

Primary source of funds for the business.

state_of_incorporationstring

State in which the business is incorporated. Only postal abbreviations (e.g. AL, CA, DE, ...) are allowed. Only required for a root entity.

websitestring

Website of the business. Optional, but highly encouraged as it will increase likelihood of an automated verification.

year_of_incorporationstring

Year in which the business entity was incorporated. Only required for a root entity.

Response

Successful response

collected_atobject

Field collection timestamps, keyed by field path (for example, first_name or ssn). Omitted when no timestamps are recorded.

idstring required

Unique identifier for the object

is_rootboolean required

Whether this entity is going to be a root entity of the platform. Root entities have special requirements and validation rules.

last_screened_atstring date-time

The timestamp at which the entity was last screened for compliance.

namestring required

Display name of the entity, derived from person or business details.

requires_screeningboolean required

Whether the entity requires additional screening before it can be verified.

review_reasonsstring[] required

List of reasons the entity is in Manual_Review.

typestring required

Type of entity. PERSON for a person entity. BUSINESS for a business entity.

verification_statusstring required

Current status of the entity verification. Can be UNVERIFIED, PENDING, MANUAL_REVIEW, VERIFIED, or DENIED.

Changes

No recorded changes to this operation across all 1 revision of this API.