> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plane.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Entity

An `Entity` represents the legal person or business entity that uses Plane. In most cases, this is your company or organization.

When you signed up for Plane, we requested information about your business. This information was used to populate the `Entity` record on your account, which serves as the foundational business identity for all operations within Plane.

We use this `Entity` information for contracts, tax reporting, payment compliance, and any other situation where we need to precisely identify the legal entity on whose behalf we are acting.

### Attributes

<ResponseField name="id" type="string">
  Unique identifier for the entity, e.g. `ent_cNqYX2J3s9bI2Aa`.
</ResponseField>

<ResponseField name="object" type="string">
  Object type. Always `entity`.
</ResponseField>

<ResponseField name="workspace" type="string">
  Identifier of the workspace the entity belongs to.
</ResponseField>

<ResponseField name="name" type="string">
  The legal name of the entity as registered with government authorities.
</ResponseField>

<ResponseField name="country" type="string">
  Two-letter ISO country code (ISO 3166-1 alpha-2) representing the country where the entity is
  legally domiciled.
</ResponseField>

<ResponseField name="address" type="object">
  The primary business address of the entity.

  <Expandable title="address attributes">
    <ResponseField name="line1" type="string">
      Address line1 (e.g. street or company name).
    </ResponseField>

    <ResponseField name="line2" type="string">
      Address line2 (e.g. apartment, suite, unit or building).
    </ResponseField>

    <ResponseField name="city" type="string">
      City, district, suburb, town, or village.
    </ResponseField>

    <ResponseField name="state" type="string">
      State, county, province, or region.
    </ResponseField>

    <ResponseField name="postal_code" type="string">
      ZIP or postal code.
    </ResponseField>

    <ResponseField name="country" type="string">
      Two-letter country code (ISO 3166-1 alpha-2).
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="status" type="string">
  The entity's verification (KYB) status. Possible values: `unverified` (verification has not yet
  cleared; the default at creation, and the status an entity returns to if verification fails),
  `pending` (details submitted and under review), or `verified` (verification cleared).
</ResponseField>

<ResponseField name="dba" type="string">
  "Doing Business As" name - the trade name used by the entity if different from the legal name.
  *Optional.*
</ResponseField>

<ResponseField name="description" type="string">
  A brief description of the entity's business activities or purpose. *Optional.*
</ResponseField>

<ResponseField name="email" type="string">
  Primary contact email address for the entity.
</ResponseField>

<ResponseField name="phone" type="string">
  Primary contact phone number for the entity.
</ResponseField>

<ResponseField name="website" type="string">
  The entity's primary website URL. *Optional.*
</ResponseField>

<ResponseField name="structure" type="string">
  The legal structure of the entity. Allowed values are `corporation`, `llc`, or `partnership`.
</ResponseField>

<ResponseField name="formation" type="object">
  Details about the entity's legal formation.

  <Expandable title="formation attributes">
    <ResponseField name="country" type="string">
      Two-letter country code (ISO 3166-1 alpha-2) where the entity was formed.
    </ResponseField>

    <ResponseField name="state" type="string">
      The state or jurisdiction where the entity was formed.
    </ResponseField>

    <ResponseField name="date" type="string">
      The date when the entity was legally formed or incorporated.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="tax_id" type="object">
  Tax identification information for the entity. Write-only: accepted when
  [creating](/reference/entities/create) or [updating](/reference/entities/update) an entity, and
  never returned in API responses.

  <Expandable title="tax_id attributes">
    <ResponseField name="number" type="string">
      The tax identification number (e.g. EIN in the US, Business Number in Canada).
    </ResponseField>

    <ResponseField name="type" type="string">
      The type of tax ID (e.g. `ein`, `ssn`, `business_number`).
    </ResponseField>

    <ResponseField name="country" type="string">
      Two-letter country code for the jurisdiction that issued the tax ID.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="metadata" type="object">
  Arbitrary key-value data attached to the entity.
</ResponseField>

<ResponseField name="created" type="string">
  Time at which the entity was created.
</ResponseField>

<ResponseField name="updated" type="string">
  Time at which the entity was last updated.
</ResponseField>

<ResponseExample>
  ```json Entity object theme={null}
  {
    "id": "ent_cNqYX2J3s9bI2Aa",
    "object": "entity",
    "workspace": "wsp_Xb2fPlgnLc",
    "name": "Acme Corporation",
    "country": "US",
    "address": {
      "line1": "123 Business Ave",
      "line2": "Suite 100",
      "city": "San Francisco",
      "state": "CA",
      "postal_code": "94105",
      "country": "US"
    },
    "status": "verified",
    "dba": "Acme",
    "description": "Technology consulting and software development services",
    "email": "contact@acmecorp.com",
    "phone": "+15551234567",
    "website": "https://www.acmecorp.com",
    "structure": "corporation",
    "formation": {
      "country": "US",
      "state": "DE",
      "date": "2020-03-15"
    },
    "metadata": {},
    "created": "2024-01-15T00:00:00Z",
    "updated": "2024-02-01T00:00:00Z"
  }
  ```
</ResponseExample>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.