The category of a transaction describe its nature or purpose. At Ntropy, we organize them into general categories and in the case of business transactions an additional accounting category.

The set of categories available is dependent on the account holder type and vary a great deal between them. If no account holder is specified for a transaction the category missing account holder information will be used.

The general categories are organized into two main classes: incoming and outgoing representing the subset of available categories for transactions of that entry_type. You can find the listing containing all the categories for each type below:

Special categories

In cases where there is not enough information to accurately classify a transaction, the API will return the category not enough information. This category is used when the available transaction data is insufficient to determine a specific category. This ensures that transactions are not incorrectly categorized when the data is ambiguous or incomplete.

The sets of categories we provide were created with a general purpose in mind. For some transactions, this is not specific enough. In these cases our categorization system will assign the category other.

Custom categories

In addition to the default categories, Ntropy allows you to define and use custom categories for your specific needs. This feature enables you to tailor our categorization system to your unique use case.

After uploading your custom categories, Ntropy will automatically use it when categorizing transactions associated with your API key. These categories will replace the default ones in the enrichment results.

If you are using recurrence, we recommend that you create a new API key. Having different sets of categories in transaction histories might yield unexpected results.

Accounting categories

This is a premium feature. Reach out to us to enable it.

For business transactions, we also provide an accounting category. The available categories are the following:

  • operational expenses
  • cost of goods sold
  • revenue
  • financing
  • taxes

Retrieving Custom Categories

To view your current set of active categories:

Set Custom Categories

To define custom categories you need to create a JSON structure that represents your desired label organization. The structure should contain two main categories: “incoming” and “outgoing”, each containing an array of labels.

Here’s an example of how to set a custom hierarchy:

Resetting Custom Categories

The API also allows you to revert to the default category set: