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.
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.
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, 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 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.
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 endpoint. 
