Skip to main content

Introduction

The Z1 Engine is designed to categorize financial transactions within a retail or corporate profile.
It provides structured outputs that allow organizations to better understand transaction behavior and generate meaningful insights.

Available Z1 profiles​

Use the data below in the API requests of categorization-v1 to start a categorization-job with a specific Z1 profile.

Engine Key
Profile Key
Metadata
z1
retail
none
z1
corporate
required

Metadata​

You can add metadata to add extra information to the categorization engine to properly process the transactions given.

Below, you will find a brief explanation of the fields that can be provided as metadata when creating a categorization job:

Key
Type
Required
Description
kvk_number
String
Only in corporate profile
8 digit Chamber of Commerce number
internal_ibans
Array of string
No
A list of IBAN numbers that the categorization engine should treat and classify as internal transactions (e.g., transfers between own accounts).
// POST cfa/CategorizationJobs
{
  "engine": "z1",
  "profile": "corporate",
  // consent, user or external user id 
  "metaData": {
    "kvk_number": "12345678"
  }
}