List entity mail

curl --request GET \
  --url https://api.getlemma.com/v0/entities/{entity_id}/mail \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "id": "inbound_mail_item_Kv7nWp3hTx9cBd5m",
      "entity_id": "entity_k7mXp2vR9nTfBw4s",
      "file_id": "file_Xt7nRv3hBw9pKm4s",
      "amount": 372500,
      "checks": [
        {
          "id": "check_deposit_Tm6bXn9hRw3pFk7c",
          "amount": 100000,
          "transaction_id": "transaction_Ab5cDx3nKv8bTh2d",
          "status": "submitted",
          "hold": {
            "status": "held",
            "automatically_releases_at": "2026-03-19T14:00:00Z",
            "released_at": null
          },
          "micr": {
            "routing_number": "021000021",
            "account_number": "9876543210",
            "auxiliary_on_us": null,
            "serial_number": "00012345"
          }
        },
        {
          "id": "check_deposit_Jd4xVs8mBn2wYh5t",
          "amount": 2000,
          "transaction_id": null,
          "status": "rejected",
          "hold": null,
          "micr": null
        }
      ],
      "received_at": "2026-03-14T14:00:00Z"
    },
    {
      "id": "inbound_mail_item_Rs4bFj8wNm2yHt6x",
      "entity_id": "entity_k7mXp2vR9nTfBw4s",
      "file_id": "file_Hd5cWm8nTx2vFk7b",
      "amount": 0,
      "checks": [],
      "received_at": "2026-03-13T10:45:00Z"
    }
  ]
}

GET

entities

{entity_id}

mail

List entity mail

curl --request GET \
  --url https://api.getlemma.com/v0/entities/{entity_id}/mail \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "id": "inbound_mail_item_Kv7nWp3hTx9cBd5m",
      "entity_id": "entity_k7mXp2vR9nTfBw4s",
      "file_id": "file_Xt7nRv3hBw9pKm4s",
      "amount": 372500,
      "checks": [
        {
          "id": "check_deposit_Tm6bXn9hRw3pFk7c",
          "amount": 100000,
          "transaction_id": "transaction_Ab5cDx3nKv8bTh2d",
          "status": "submitted",
          "hold": {
            "status": "held",
            "automatically_releases_at": "2026-03-19T14:00:00Z",
            "released_at": null
          },
          "micr": {
            "routing_number": "021000021",
            "account_number": "9876543210",
            "auxiliary_on_us": null,
            "serial_number": "00012345"
          }
        },
        {
          "id": "check_deposit_Jd4xVs8mBn2wYh5t",
          "amount": 2000,
          "transaction_id": null,
          "status": "rejected",
          "hold": null,
          "micr": null
        }
      ],
      "received_at": "2026-03-14T14:00:00Z"
    },
    {
      "id": "inbound_mail_item_Rs4bFj8wNm2yHt6x",
      "entity_id": "entity_k7mXp2vR9nTfBw4s",
      "file_id": "file_Hd5cWm8nTx2vFk7b",
      "amount": 0,
      "checks": [],
      "received_at": "2026-03-13T10:45:00Z"
    }
  ]
}

Returns a list of all mail items received at the entity’s lockbox. Each item includes a file_id for the scanned PDF and an amount representing the total value of any checks found in that piece of mail. If the mail contained checks, they are listed in the checks array.

Path parameters

entity_id

string

required

The ID of the entity. You can find entity IDs using the List entities endpoint.

Query parameters

received.on_or_after

string

Filter to mail received at or after this timestamp. ISO 8601 format.

received.on_or_before

string

Filter to mail received at or before this timestamp. ISO 8601 format.

Response

data

object[]

The list of mail objects.

Show Mail object

string

Unique identifier for the lockbox mail item.

entity_id

string

The ID of the entity whose lockbox received this mail.

file_id

string

The ID of the scanned PDF. Use the Get PDF endpoint to retrieve a temporary download URL.

amount

integer

The total value of all checks in this piece of mail, in cents. Zero if no checks were found.

checks

object[]

The checks found in this piece of mail. Empty array if no checks were found.

Show Check object

string

Unique identifier for the check, prefixed with check_deposit_.

amount

integer

The amount of the check in cents.

transaction_id

string | null

The ID for the transaction created by the check deposit. Null if the check is pending manual intervention.

status

string

The processing status of the check. One of pending, submitted, returned, or rejected.Pending means Lemma has not attempted to deposit the check yet.Submitted means the check has been submitted for deposit. There will be a hold on the funds for a few days.Returned checks are unlikely to happen to healthcare practices receiving funds from payers. Nevertheless, here are a few common reasons checks are returned:

Insufficient funds
Stop payment instructions
The check was drawn from a closed bank account
The check was not authorized

We’ll reach out if a check is returned to share additional details.Rejected checks are rare. We reject checks if it’s impossible to deposit the check after a manual review. For example, a payer could’ve sent you another entity’s check. You can use the Get PDF endpoint to see for yourself why the check was unrelated to your account.

hold

object | null

Fund hold details. Present when deposited funds are held before becoming available. Null if there is no hold.

Show Hold object

status

string

The hold status. One of held or complete.

automatically_releases_at

string

ISO 8601 timestamp of when the hold will automatically release.

released_at

string | null

ISO 8601 timestamp of when the hold was released. Null if the hold has not been released yet.

micr

object | null

Fields read from the check’s MICR line. Null when we have not submitted the check for deposit.

Show MICR object

routing_number

string

The routing number printed on the check.

account_number

string

The account number printed on the check.

auxiliary_on_us

string | null

An additional identifier from the MICR line. Business checks typically encode the check number here rather than in serial_number.

serial_number

string | null

The check number. For business checks, this may be null — look at auxiliary_on_us instead.

received_at

string

ISO 8601 timestamp of when the mail was received at the lockbox.

{
  "data": [
    {
      "id": "inbound_mail_item_Kv7nWp3hTx9cBd5m",
      "entity_id": "entity_k7mXp2vR9nTfBw4s",
      "file_id": "file_Xt7nRv3hBw9pKm4s",
      "amount": 372500,
      "checks": [
        {
          "id": "check_deposit_Tm6bXn9hRw3pFk7c",
          "amount": 100000,
          "transaction_id": "transaction_Ab5cDx3nKv8bTh2d",
          "status": "submitted",
          "hold": {
            "status": "held",
            "automatically_releases_at": "2026-03-19T14:00:00Z",
            "released_at": null
          },
          "micr": {
            "routing_number": "021000021",
            "account_number": "9876543210",
            "auxiliary_on_us": null,
            "serial_number": "00012345"
          }
        },
        {
          "id": "check_deposit_Jd4xVs8mBn2wYh5t",
          "amount": 2000,
          "transaction_id": null,
          "status": "rejected",
          "hold": null,
          "micr": null
        }
      ],
      "received_at": "2026-03-14T14:00:00Z"
    },
    {
      "id": "inbound_mail_item_Rs4bFj8wNm2yHt6x",
      "entity_id": "entity_k7mXp2vR9nTfBw4s",
      "file_id": "file_Hd5cWm8nTx2vFk7b",
      "amount": 0,
      "checks": [],
      "received_at": "2026-03-13T10:45:00Z"
    }
  ]
}

List bank accounts Get a check deposit

​Path parameters

​Query parameters

​Response

Path parameters

Query parameters

Response