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

# List entities

> Returns a list of the legal entities in your Plane workspace.

### Parameters

<ParamField query="limit" type="number">
  A limit on the number of objects to be returned. Limit can range between 1 and 100, and the
  default is 10.
</ParamField>

<ParamField query="starting_after" type="string">
  A cursor for use in pagination. `starting_after` is an object ID that defines your place in the
  list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`,
  your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the
  list.
</ParamField>

<ParamField query="ending_before" type="string">
  A cursor for use in pagination. ending\_before is an object ID that defines your place in the list.
  For instance, if you make a list request and receive 100 objects, starting with obj\_bar, your
  subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the
  list.
</ParamField>

<ParamField query="status" type="string">
  Return only entities with this verification status. Possible values: `unverified`, `pending`, or
  `verified`.
</ParamField>

<ParamField query="country" type="string">
  Return only entities domiciled in this two-letter ISO country code, e.g. `US`.
</ParamField>

### Returns

A dictionary with an `entities` property that contains an array of up to `limit` entities, starting
after entity `starting_after`. Each entry in the array is a separate
[Entity object](/reference/entities/object). If no more entities are available, the resulting array
will be empty.

<ResponseExample>
  ```json Response theme={null}
  {
    "entities": [
      {
        "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>