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

beneficial_owners

array of objects

A list of all the persons who have ultimate control over funds in the business, whether through ownership or other means. This is anyone who owns 25% or more of the business and those who control the funds. If no one owns more than 25% of the business, just the individual who has ultimate control of the funds must be included.

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

country_of_citizenship

string

Country of citizenship of the individual. Country of citizenship does not need to match the issuing country of an identity document. ISO 3166-1 Alpha-2 Country Code (e.g., US, FR, UK, DE, ...).

date_of_birth

string

Date of birth (YYYY-MM-DD)

drivers_license

object

Driver's License Details. Passport, Driver's License or National ID is required for non U.S. citizens. When left blank, the Passport field returns an empty object ( ) and the Driver's License and National ID fields return null.

country_code

string

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

number

string

Driver's license number

email

string

Email of the individual. Optional, but highly encouraged as it will increase likelihood of an automated verification. When left blank, the Email field returns an empty string ("").

employment_status

string

Employment status of the individual.

expected_payment_rails

string

Expected transaction types for the account.

first_name

string

First name of the legal person. Must adhere to Fedwire character validation.

income

array of numbers

Estimated pre-tax annual income. Accepts an array to allow passing income ranges.

is_beneficial_owner

boolean

Boolean value which specifies if this person is a designated beneficial owner.

is_control_person

boolean

Boolean value which specifies if this person is a designated control person.

is_high_risk

boolean

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

job_title

string

Job title of the beneficial owner or control person.

last_name

string

Last name of the legal person. Must adhere to Fedwire character validation.

makes_international_payments

boolean

Indicates whether the individual expects to make international payments.

middle_name

string

Middle name of the legal person. Must adhere to Fedwire character validation.

national_id

object

National ID Details. Passport, Driver's License or National ID is required for non U.S. citizens. When left blank, the Passport field returns an empty object ( ) and the Driver's License and National ID fields return null.

country_code

string

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

number

string

National ID number

occupation

string

Industry of employment or occupation of the individual.

ownership_percentage

integer

Percentage ownership, specified as an integer, of the beneficial owner

passport

object

Passport Details. Passport, Driver's License or National ID is required for non U.S. citizens. When left blank, the Passport field returns an empty object ( ) and the Driver's License and National ID fields return null.

country_code

string

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

number

string

Passport number

pep_status

string

Politically Exposed Person screening status. Allowed values: not_checked, no, yes, potential.

phone_number

string

Phone number of the individual in the E.164 format. Optional, but highly encouraged as it will increase likelihood of an automated verification. When left blank, the phone number field returns an empty string ("").

purpose_of_account

array of strings

Intended use of the account.

role

string

Individual's role or job title at their place of employment.

source_of_income

array of strings

Sources of income for the individual.

ssn

string

Social Security Number. SSN is required for U.S. citizens. ITIN may be shared in place of SSN. If SSN is provided, country of citizenship is not required. When left blank (i.e., for non-U.S. citizens) the SSN field returns an empty string ("").

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.

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.