---
title: "List user account entity relationships"
method: GET
path: "/v2/user_accounts/{user_account_id}/entity_relationships"
tags: ["User Account"]
---

# List user account entity relationships

`GET /v2/user_accounts/{user_account_id}/entity_relationships`

## Request

- Base URL: `https://api.sandbox.lead.bank`
- URL: `https://api.sandbox.lead.bank/v2/user_accounts/{user_account_id}/entity_relationships`
- Auth: HTTP bearer

List the Entities on a User Account and their relationship types.

## Path parameters

- `user_account_id` string, required: The ID of the User Account object.

## Query parameters

- `limit` integer
- `starting_after` string

## Response `200`

List of entity relationships for the user account.

- object
  - `has_more` boolean, required: Indicates whether more results are available beyond this page.
  - `cursor` string: Cursor to retrieve the next page of results. Only present when has_more is true.
  - `objects` EntityRelationship[], required
    - `entity_id` string, required: The ID of your entity.
    - `relationship_type` 'account_holder' | 'authorized_signer' | 'authorized_user', required: Indicates the type of Entity

## Other responses

- `400`: The request could not be parsed.
- `403`: `code` is one of: `authentication_missing` (the request has no credentials), `token_invalid` (the bearer token is missing, expired, or invalid, or does not grant `user_account/read` or `user_account/read_write`), `source_ip_not_permitted` (the request came from an IP address that is not on your program's allowlist).
- `404`: No user account exists with this ID, or it is not visible to your program.
- `422`: `code` is one of: `parameters_invalid` (`limit` is outside 1 to 100 (`schema_violation`), or the `starting_after` cursor cannot be decoded (`value_malformed`)), `lead_control_restricted` (your program is not enabled for User Accounts v2; `errors[].code` is `feature_not_enabled`).
- `429`: Rate limit exceeded.
- `500`: Internal server error.
- `503`: The service or endpoint is temporarily unavailable. Retry after a delay.
- `504`: An upstream system did not respond in time. Retry with backoff.

## Changes

- **2026-11-03** `2c659854496e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/lead/apis/lead-bank/changes/v2/user_accounts/:user_account_id/entity_relationships/get.md)

---

[API](https://skmtc.dev/lead/apis/lead-bank.md) - [All operations](https://skmtc.dev/lead/apis/lead-bank/llms.txt) - [OpenAPI document](https://skmtc.dev/lead/apis/lead-bank/revisions/2c659854496e?raw)