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 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:

1from ntropy_sdk import SDK
2
3sdk = SDK("cd1H...Wmhl" )
4for tx in sdk.transactions.list(
5 account_holder_id="35b927b6-6fda-40aa-93b8-95b47c2b2cad"
6).auto_paginate():
7 ...