Categorization feedback

Categorization feedback lets you report a corrected category for a transaction after it has been categorized. The feedback is stored for review by EnableNow and can be used to improve categorization quality.

Use this endpoint when you already have the full transaction snapshot available. The request should include the current categorization result and the category you believe should be applied instead.

Request Method: POST

https://api.enablenow.nl/v2/categorization-feedback

info

The feedback request must be self-contained. Include the transaction details in the request body, even if the transaction was originally retrieved from another EnableNow endpoint.

Request body

{
  "engine": "e1",
  "countryCode": "nl",
  "profile": "retail",
  "transactionId": "d20840e5-8ee7-52cd-8dd8-c49cab7f1da9",
  "accountId": "a1f2279e-9e36-44ec-a2fc-72a2a661c902",
  "amount": -65.45,
  "currency": "EUR",
  "description": "Je klantnummer 12345678 Je factuurnummer 654321234 Factuurdatum 03 juli 2026.",
  "counterpartDescription": "ZIGGO SERVICES B.V.",
  "counterpartAccountNumber": "NL91ABNA0417164300",
  "providerKey": "ENSANDBOX",
  "transactionType": "card",
  "transactionTypeName": "Card payment",
  "reasonCode": null,
  "purposeCode": null,
  "originalCategory": "expense.other",
  "originalFlags": [],
  "targetCategory": "expense.essential.telecom",
  "targetFlags": ["refund"],
  "remark": "The customer marked this as a telecom bill."
}

Fields

Field

Required

Description

engine

Yes

Categorization engine used for the original result. Supported values are e1 and z2.

countryCode

Yes

Two-letter country code for the categorization context, for example nl.

profile

Yes

Categorization profile, for example retail or corporate.

transactionId

No

Identifier of the transaction, when available.

accountId

No

Identifier of the account, when available.

amount

Yes

Transaction amount.

currency

Yes

Transaction currency. Maximum length is 3 characters.

description

No

Transaction description. Maximum length is 4096 characters.

counterpartDescription

No

Name or description of the counterparty. Maximum length is 4096 characters.

counterpartAccountNumber

No

Counterparty account number. Maximum length is 128 characters.

providerKey

Yes

Provider key for the transaction source. Maximum length is 128 characters.

transactionType

No

Provider transaction type. Maximum length is 128 characters.

transactionTypeName

No

Provider transaction type name. Maximum length is 256 characters.

reasonCode

No

Reason code, when supplied by the provider. Maximum length is 64 characters.

purposeCode

No

Purpose code, when supplied by the provider. Maximum length is 64 characters.

originalCategory

No

Category originally returned by the categorization engine. Maximum length is 256 characters.

originalFlags

No

Flags originally returned by the categorization engine. A maximum of 3 flags is allowed.

targetCategory

Yes

Correct category suggested by the user or integration. Maximum length is 256 characters.

targetFlags

No

Correct flags suggested by the user or integration. A maximum of 3 flags is allowed.

remark

No

Optional explanation for the correction. Maximum length is 2048 characters.

Response

A successful request returns 202 Accepted. The feedback is queued for review and does not immediately change the categorization result returned by previous jobs or transaction endpoints.