> ## 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 external accounts

> Retrieve saved external accounts for an entity.

Returns a paginated list of saved external accounts for an entity, ordered by
most recent first. Results are [paginated](/api-reference/pagination).

## Query parameters

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

<ParamField query="limit" type="integer" default="20">
  Maximum number of external accounts 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="has_next" type="boolean">
  Whether more external accounts 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>

<ResponseField name="data" type="object[]">
  The list of external account objects.

  <Expandable title="External account object">
    <ResponseField name="id" type="string">
      Unique identifier for the external account, prefixed with
      `external_account_`.
    </ResponseField>

    <ResponseField name="entity_id" type="string">
      The ID of the entity that owns this external account.
    </ResponseField>

    <ResponseField name="nickname" type="string">
      The human-readable label for this external account.
    </ResponseField>

    <ResponseField name="created_at" type="string">
      The timestamp when the external account was created, in ISO 8601 format.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "data": [
      {
        "id": "external_account_Hd9vWs4mFn7xYk2t",
        "entity_id": "entity_k7mXp2vR9nTfBw4s",
        "created_at": "2026-03-20T18:45:00Z",
        "nickname": "Owner's Account"
      },
      {
        "id": "external_account_Bx5nTm8hKw3pVd7c",
        "entity_id": "entity_k7mXp2vR9nTfBw4s",
        "created_at": "2026-03-19T18:45:00Z",
        "nickname": "Payroll"
      }
    ],
    "has_next": false,
    "cursor": null
  }
  ```
</ResponseExample>