# 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](/wire#valid-characters-permitted).
    - `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`.

**Response 200**

```json
{
  "business_details": {
    "account_usage": "business_operations",
    "address": {
      "city": "San Francisco",
      "country_code": "US",
      "line_1": "101 Market St",
      "line_2": "Suite 1913",
      "postal_code": "94105",
      "state": "CA"
    },
    "business_name": "Example business name",
    "countries_of_operation": [
      "US"
    ],
    "country_of_incorporation": "US",
    "date_of_incorporation": "2024-01-15",
    "dba_name": "Example dba name",
    "description": "Example description",
    "ein": "12-3456789",
    "ein_pending": false,
    "end_customer_type": "individual",
    "expected_payment_rails": "ach",
    "expected_use_of_funds": null,
    "has_virtual_address": false,
    "industry": "Technology",
    "is_high_risk": false,
    "legal_type": "llc",
    "makes_international_payments": false,
    "payment_volumes": null,
    "purpose_of_account": "business_operations",
    "registration_id": {
      "number": "A12345678",
      "country_code": "US"
    },
    "source_of_funds": "example_source_of_funds",
    "state_of_incorporation": "DE",
    "website": "https://example.com",
    "year_of_incorporation": "2020"
  },
  "collected_at": {},
  "documents": [
    {
      "created_at": "2024-01-15T09:30:00Z",
      "description": "Example description",
      "document_id": "docu_2Q1ctiJm1NypVqCt8UBC8e4xTfH",
      "entity_id": "enti_2Q1ctiJm1NypVqCt8UBC8e4xTfH"
    }
  ],
  "id": "item_2Q1ctiJm1NypVqCt8UBC8e4xTfH",
  "is_root": false,
  "last_screened_at": "2024-01-15T09:30:00Z",
  "name": "Example name",
  "requires_screening": false,
  "review_reasons": [
    null
  ],
  "search_metadata": {
    "highlights": {},
    "score": 0
  },
  "type": "BUSINESS",
  "verification_status": "pending"
}
```