Pagination

List endpoints return results one page at a time using cursor-based pagination. Each response includes a data array for the current page, a has_next boolean, and a cursor string to fetch the next page. Cursor pagination is stable within a single pass: inserting or deleting records while you page will not cause items to be skipped or duplicated.

Query parameters

All paginated endpoints accept these parameters:

Parameter	Type	Default	Maximum	Description
`limit`	integer	`10`	`100`	Items per page
`cursor`	string	—	—	Cursor from the previous response. Omit for first page.

A limit that is not a whole number between 1 and 100 is rejected with a 400 error.

Response structure

{
  "data": [...],
  "has_next": true,
  "cursor": "eyJvcGVuZWRfYXQiOiIyMDI2LTAzLTEyVDE2OjQ1OjAwWiIsImlkIjoiYWNjb3VudF9XcDVtUngzbkt2OGJUaDJkIn0"
}

cursor is null when this is the last page. Pass it as the cursor query parameter on the next request to fetch the following page.

Fetching all pages

To retrieve every item, keep requesting until has_next is false:

async function fetchAllTransactions(accountId: string) {
  const results = [];
  let cursor: string | null = null;

  do {
    const params = new URLSearchParams({ account_id: accountId, limit: "100" });
    if (cursor) {
      params.set("cursor", cursor);
    }

    const response = await fetch(
      `https://api.getlemma.com/v0/transactions?${params}`,
      { headers: { Authorization: `Bearer ${API_KEY}` } },
    );
    const page = await response.json();

    results.push(...page.data);
    cursor = page.has_next ? page.cursor : null;
  } while (cursor);

  return results;
}

Keeping a local copy in sync

Do not save a cursor and reuse it on a later run. Cursors page from newest to oldest, so resuming from a stored cursor returns records older than your bookmark and never the new ones that arrived above it. There is also no cursor to save at the end of a pass: cursor is null on the last page.

Getting started

Concepts

Entities

Bank Accounts

Lockbox

Check deposits

Remittances

Transactions

External accounts

Cards

Book transfers

ACH transfers

Query parameters

Response structure

Fetching all pages

Keeping a local copy in sync

​Query parameters

​Response structure

​Fetching all pages

​Keeping a local copy in sync

Query parameters

Response structure

Fetching all pages

Keeping a local copy in sync