> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.ntropy.com/account-holders/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.ntropy.com/_mcp/server.

# Account Holders

When using the Ntropy API, you can provide information about the account holder of a certain transaction. In this way,
when you enrich a transaction using the API or SDK, it will also be added to that account holder's transaction history.

An account holder represents an entity (business, consumer) that can be uniquely identified by an `id` and holds
the account associated with the transaction.

Account holders provide important context for understanding transactions and allow additional operations such as:

- Identifying **recurrence** between transactions of the same account.
- Insights for an account holder such as income information over a period of time, subscriptions, and so on.

# Optional account holder fields

Account holders allow for optional fields that can [improve the quality](./identification#account-holder-disambiguation)
of the enrichment significantly:

- `name`: The name of the account holder
- `industry`: The industry in which the account holder operates
- `website`: The website of the account holder


# Accessing account holder history

At any point, after adding transactions to an account holder's history. You can retrieve it
by supplying its `id` to the [Transactions API](/documentation/api/transactions):


<CodeBlocks>

**`SDK`**

```python title="SDK"
from ntropy_sdk import SDK

sdk = SDK("cd1H...Wmhl")
for tx in sdk.transactions.list(
        account_holder_id="35b927b6-6fda-40aa-93b8-95b47c2b2cad"
).auto_paginate():
    ...
```

**`cURL`**

```bash title="cURL"
curl -X "GET" \
    "https://api.ntropy.com/v3/transactions?account_holder_id=35b927b6-6fda-40aa-93b8-95b47c2b2cad" \
    -H "Accept: application/json" \
    -H "X-API-KEY: cd1H...Wmhl"
```
</CodeBlocks>

<Accordion title='See the full raw output'>
    <EndpointResponseSnippet endpoint="GET /v3/transactions" />
</Accordion>

-----------------------------