post
https://sandbox.api.nogginhq.com/api/v1/categorisation
Enrich transaction data using the Categorisation endpoint.
Formatting Requirements
To ensure accurate processing and categorisation, please adhere to the following formatting rules when submitting transaction data:
-
Amount Sign Convention:
- Credit (Incoming transactions): must be negative 🚨
- Debit (Outgoing transactions): must be positive 🚨
{ "original_description": "Salary Payment", "amount": -5000.00 // Credit } { "original_description": "Noggin Store", "amount": 150.75 // Debit }This convention is required for correct transaction direction detection and downstream categorisation.
-
Date Format:
- Dates must be provided in the following format: YYYY-MM-DD 🚨
- No other date formats are supported
Failure to follow these conventions may result in incorrect categorisation or rejected requests.
Optional Fields
To enhance categorisation accuracy, you should include the following additional contextual fields in your request payload.
- Customer Name: The name of the customer as it appears on the account.
- Account Information: A list of bank accounts associated with the provided transactions.
Note: Omitting these fields will result in reduced accuracy.
400Bad Request
401Unauthorized
