Create a business entity
Create a new business entity.
Request
- Base URL: https://api.column.com
- URL: https://api.column.com/entities/business
- Auth: HTTP basic
Headers
Idempotency keys can be up to 255 characters long and are case sensitive. Column reserves the right to expire idempotency keys after 30 days. Only ASCII printable characters (code 32 - 126) are allowed for idempotency keys.
Request body
Indicates possible uses of the accounts an entity may use at Column. Only required for a root entity.
Legal Business Name
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. An empty map records no timestamps. Nested beneficial owner fields do not support collected_at; attest beneficial owners separately as person entities. Idempotency replays return the original resource without re-applying timestamps.
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 in which the business is incorporated. ISO 3166-1 Alpha-2 Country Code.
Date on which the business was incorporated. Format: YYYY-MM-DD.
Doing Business As name, if different from the legal business name.
Description of the business entity. Only required for a root entity.
Employer Identification Number (Tax ID). This may be SSN for a sole proprietorship. At least one form of business identification (ein or registration_id) is required unless ein_pending is set to true.
Set to true if the business has applied for an EIN but has not yet received it. When true, ein and registration_id must not be provided. Cannot be true for root entities.
Type of end customer the business serves. Accepts a free-form string.
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 funds for the business accounts. Accepts a free-form string.
Indicates whether the business uses a virtual address.
Industry in which the business entity operates.
Indicates whether the entity has been identified as high risk based on compliance screening
Whether this entity is going to be a root entity of the platform. Root entities have special requirements and validation rules.
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.
Indicates whether the business expects to make international payments.
Expected payment volumes. Only required for a root entity.
Intended use of the account.
Registration ID. At least one form of business identification (ein or registration_id) is required unless ein_pending is set to true.
Primary source of funds for the business.
State in which the business is incorporated. Only postal abbreviations (e.g. AL, CA, DE, ...) are allowed. Only required for a root entity.
Website of the business. Optional, but highly encouraged as it will increase likelihood of an automated verification.
Year in which the business entity was incorporated. Only required for a root entity.
Response
Successful response
Field collection timestamps, keyed by field path (for example, first_name or ssn). Omitted when no timestamps are recorded.
Unique identifier for the object
Whether this entity is going to be a root entity of the platform. Root entities have special requirements and validation rules.
The timestamp at which the entity was last screened for compliance.
Display name of the entity, derived from person or business details.
Whether the entity requires additional screening before it can be verified.
List of reasons the entity is in Manual_Review.
Type of entity. PERSON for a person entity. BUSINESS for a business entity.
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.