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-v2 to start a categorization-job with a specific Z1 profile.

Engine Key
Profile Key
Metadata
z1
retail
none
z1
corporate
required

Metadata​

Some profiles require specific metadata to ensure that the categorization engine can classify transactions more accurately.

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

Corporate profile metadata​

Key
Type
Required
Description
kvk_number
String
Yes
8 digit Chamber of Commerce number
// POST cfa/CategorizationJobs
{
  "engine": "z1",
  "profile": "corporate",
  // consent, user or external user id 
  "metaData": {
    "kvk_number": "12345678"
  }
}