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

# List entities

> Retrieve a list of entities available to your API key.

Retrieve a paginated list of entities associated with your organization. Use the
entity ID to access detailed information via the [Get entity](/api-reference/get-entity),
[accounts](/api-reference/list-bank-accounts), and [mail](/api-reference/list-entity-mail)
endpoints. Results are [paginated](/api-reference/pagination).

## Query parameters

<ParamField query="limit" type="integer" default="20">
  Maximum number of entities to return per page. Maximum is 100.
</ParamField>

<ParamField query="cursor" type="string">
  Pagination cursor for retrieving the next page of results. Returned as
  `cursor` in the response. See [pagination](/api-reference/pagination) for
  details.
</ParamField>

## Response

<ResponseField name="has_next" type="boolean">
  Whether more entities exist beyond this page. Use the `cursor` field to
  retrieve the next page.
</ResponseField>

<ResponseField name="cursor" type="string | null">
  Cursor to retrieve the next page of results. Null if this is the last page.
  Pass this value as the `cursor` query parameter in a subsequent request. See
  [pagination](/api-reference/pagination) for details.
</ResponseField>

<ResponseField name="data" type="object[]">
  The list of entity objects. Each object carries the same fields as the [Get
  entity](/api-reference/get-entity) response.

  <Expandable title="Entity object">
    <ResponseField name="id" type="string">
      Unique identifier for the entity, prefixed with `entity_`.
    </ResponseField>

    <ResponseField name="created_at" type="string">
      ISO 8601 timestamp of when the entity was created.
    </ResponseField>

    <ResponseField name="name" type="string">
      The name of the entity or practice.
    </ResponseField>

    <ResponseField name="structure" type="string">
      The entity's legal structure. One of `fqhc`, `govt`,
      `professional_corporation`, `professional_llc`, `llc`, `corporation`,
      `partnership`, `sole_prop`, or `nonprofit`.
    </ResponseField>

    <ResponseField name="npi" type="string | null">
      The entity's 10-digit National Provider Identifier.
    </ResponseField>

    <ResponseField name="address" type="object">
      The entity's business address.

      <Expandable title="address">
        <ResponseField name="line1" type="string">
          Street address line 1.
        </ResponseField>

        <ResponseField name="line2" type="string">
          Street address line 2, or an empty string if not set.
        </ResponseField>

        <ResponseField name="city" type="string">
          City.
        </ResponseField>

        <ResponseField name="state" type="string">
          Two-letter state code.
        </ResponseField>

        <ResponseField name="postalCode" type="string">
          ZIP code.
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "data": [
      {
        "id": "entity_k7mXp2vR9nTfBw4s",
        "created_at": "2026-07-01T09:30:00Z",
        "name": "Riverside Family Medicine",
        "structure": "professional_llc",
        "npi": "1234567890",
        "address": {
          "line1": "2261 Market St",
          "line2": "Ste 1234",
          "city": "San Francisco",
          "state": "CA",
          "postalCode": "94114"
        }
      },
      {
        "id": "entity_Yd3hNx8cWqJ5Fp7m",
        "created_at": "2026-07-01T14:12:00Z",
        "name": "Summit Orthopedics",
        "structure": "sole_prop",
        "npi": null,
        "address": {
          "line1": "500 Alpine Way",
          "line2": "",
          "city": "Denver",
          "state": "CO",
          "postalCode": "80202"
        }
      }
    ],
    "has_next": false,
    "cursor": null
  }
  ```
</ResponseExample>