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

> Retrieve an entity's remittances and whether an 835 is available for each.

Returns a paginated list of an entity's remittances, ordered by most recently
updated first. Only remittances derived from an electronic remittance advice —
those an 835 can be generated from — are returned. Results are
[paginated](/api-reference/pagination).

Each remittance exposes whether its 835 is currently available. Fetch the 835
itself with [Fetch a remittance's 835](/api-reference/get-remittance-era).

## Query parameters

<ParamField query="entity_id" type="string" required>
  The ID of the entity whose remittances to list. You can find entity IDs using
  the [List entities](/api-reference/list-entities) endpoint.
</ParamField>

<ParamField query="updated_since" type="string">
  Return only remittances updated at or after this timestamp (ISO 8601). Pass
  the largest `updated_at` you have already seen to poll for changes
  incrementally.
</ParamField>

<ParamField query="received_on_or_after" type="string">
  Return only remittances with a remittance date on or after this date
  (YYYY-MM-DD).
</ParamField>

<ParamField query="received_on_or_before" type="string">
  Return only remittances with a remittance date on or before this date
  (YYYY-MM-DD).
</ParamField>

<ParamField query="payer" type="string">
  Return only remittances whose payer name contains this text.
</ParamField>

<ParamField query="limit" type="integer" default="10">
  Maximum number of remittances 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="data" type="object[]">
  The list of remittance objects.

  <Expandable title="Remittance object">
    <ResponseField name="id" type="string">
      Stable remittance identifier. Pass it to [Fetch a remittance's
      835](/api-reference/get-remittance-era) to retrieve the 835.
    </ResponseField>

    <ResponseField name="entity_id" type="string">
      The ID of the entity the remittance belongs to.
    </ResponseField>

    <ResponseField name="payer_name" type="string | null">
      Payer name as it appears on the remittance.
    </ResponseField>

    <ResponseField name="payment" type="object">
      Payment-level details for the remittance.

      <Expandable title="payment">
        <ResponseField name="amount" type="integer | null">
          Total paid amount, in cents.
        </ResponseField>

        <ResponseField name="trace_number" type="string | null">
          Check or EFT trace number.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="remittance_date" type="string | null">
      Date the remittance was received, as a calendar date (YYYY-MM-DD).
    </ResponseField>
  </Expandable>
</ResponseField>

<Info>
  Only remittances whose 835 is ready to serve are listed, so every `id` here
  resolves on [Fetch a remittance's 835](/api-reference/get-remittance-era).
</Info>

<ResponseField name="has_next" type="boolean">
  Whether more remittances 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>

<ResponseExample>
  ```json 200 theme={null}
  {
    "data": [
      {
        "id": "remittance_DrE8uykrS8bg",
        "entity_id": "entity_k7mXp2vR9nTfBw4s",
        "payer_name": "Cigna",
        "payment": { "amount": 172800, "trace_number": "EFT202603200042" },
        "remittance_date": "2026-03-20"
      },
      {
        "id": "remittance_Qw3Zmn7Ht2Lp",
        "entity_id": "entity_k7mXp2vR9nTfBw4s",
        "payer_name": "United Health",
        "payment": { "amount": 45200, "trace_number": null },
        "remittance_date": "2026-03-18"
      }
    ],
    "has_next": false,
    "cursor": null
  }
  ```
</ResponseExample>