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

# Entities

> Legal entities that hold accounts on Lemma.

An entity is a healthcare practice or legal entity that holds accounts on Lemma. Every account, transfer, check, and external account in Lemma belongs to an entity. Entities are the top-level organizational unit in the API — most endpoints require an `entity_id` or are scoped to a single entity.

<Tip>
  The Lemma dashboard URLs include the entity ID (e.g.
  `app.getlemma.com/entity_abc123`). If you have dashboard access for an entity,
  paste their ID into the URL to jump straight to that entity.
</Tip>

## What Lemma tracks

When an entity is onboarded, Lemma captures and verifies several pieces of information:

* **Legal entity details** — the entity's legal name, structure (e.g., professional LLC, sole proprietorship), and state of incorporation. These determine which banking products the entity is eligible for.
* **NPI number** — the entity's 10-digit [National Provider Identifier](https://www.cms.gov/medicare/enrollment-renewal/providers-suppliers/national-provider-identifier-standard), issued by CMS. Lemma uses the NPI to uniquely identify healthcare entities and to match incoming insurance payments to the correct account.
* **KYC information** — Lemma collects Know Your Customer details (beneficial owners, EIN, address) as part of onboarding to satisfy regulatory requirements. This information is not exposed through the API.

## Legal structures

Each entity has a `structure` field that reflects its legal entity type. Lemma supports:

| Structure                | Value                      |
| ------------------------ | -------------------------- |
| Professional corporation | `professional_corporation` |
| Professional LLC         | `professional_llc`         |
| LLC                      | `llc`                      |
| Partnership              | `partnership`              |
| Sole proprietorship      | `sole_prop`                |
| Management services org  | `mso`                      |
| Nonprofit                | `nonprofit`                |

## Listing and finding entities

The [List entities](/api-reference/list-entities) endpoint returns all entities that have granted access to your platform. An entity can limit access to only certain bank accounts.

To find a specific entity, pass the `npi` query parameter. NPI numbers are not guaranteed to be unique across entities — multiple legal entities can share the same NPI (e.g., when a group practice reorganizes or when separate entities bill under a shared organizational NPI), so the endpoint may return more than one result.

```bash theme={null}
curl "https://api.getlemma.com/v0/entities?npi=1234567890" \
  -H "Authorization: Bearer lm_key_your_api_key"
```

## Lockbox address

Every entity is assigned a lockbox mailing address. Payers send checks and correspondence to this address, and Lemma automatically scans and deposits them. Retrieve an entity's lockbox address with the [Get entity](/api-reference/get-entity) endpoint.