Business entity object

A business entity represents a legal business in the Column data model.

Object Parameters

business_details

object

Business details for business entities. Present on single-entity responses, omitted in list responses.

account_usage

string

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

address

object

Addresses need to adhere to character validation, as addresses are used across multiple payment rails. Characters are validated according to the Fedwire character validation.

city

string

City name

country_code

string

Two-letter ISO 3166-1 alpha-2 country code (e.g. US)

line_1

string

Street address line 1

line_2

string

Street address line 2

postal_code

string

Postal or ZIP code

state

string

State or province

business_name

string

Legal Business Name

countries_of_operation

array of strings

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_incorporation

string

ISO 3166-1 Alpha-2 country code of the country in which the business is incorporated.

date_of_incorporation

string

Date the business was incorporated (YYYY-MM-DD).

dba_name

string

"Doing business as" name for the business entity, when different from the legal business name.

description

string

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

ein

string

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

ein_pending

boolean

Indicates whether the business has applied for an EIN but has not yet received it.

end_customer_type

string

Type of end customer the business serves.

expected_payment_rails

string

Expected transaction types for the account.

expected_use_of_funds

string

Expected use of funds for the business entity.

has_virtual_address

boolean

Indicates whether the business operates from a virtual address.

industry

string

Industry in which the business entity operates.

is_high_risk

boolean

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

legal_type

string

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_payments

boolean

Indicates whether the business expects to make international payments.

payment_volumes

string

Expected payment volumes. Only required for a root entity.

purpose_of_account

string

Intended use of the account.

registration_id

object

Registration ID. EIN or Registration ID is required.

country_code

string

Two-letter ISO 3166-1 alpha-2 country code of the issuing country

number

string

Registration or identification number (alphanumeric, up to 32 characters)

source_of_funds

string

Source of funds for the business entity.

state_of_incorporation

string

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

website

string

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

year_of_incorporation

string

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

collected_at

object

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

documents

array of objects

List of documents which are uploaded with the Submit Document API

created_at

date-time

Timestamp at which the document was created.

description

string

Description of the uploaded document.

document_id

string

Unique identifier of the document.

entity_id

string

Unique identifier of the entity the document belongs to.

id

string

Unique identifier for the object

is_root

boolean

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

last_screened_at

date-time

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

name

string

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

requires_screening

boolean

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

review_reasons

array of strings

List of reasons the entity is in Manual_Review.

search_metadata

object

Search-specific metadata returned when a query is provided.

highlights

object

Matched field fragments with highlighted terms

score

number

OpenSearch relevance score

type

string

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

verification_status

string

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