> ## 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="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">
  Current operational status of the entity. Common values include `active`, `inactive`, `pending`,
  or `suspended`.
</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.

  <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>

<ResponseExample>
  ```json Entity object theme={null}
  {
    "id": "ent_cNqYX2J3s9bI2Aa",
    "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"
    },
    "tax_id": {
      "number": "123456789",
      "type": "ein",
      "country": "US"
    }
  }
  ```
</ResponseExample>