# Adds categorisation, classification and predicts a merchant name for transactions supplied.

Endpoint: POST /insights-engine/v1/enrich-transactions
Version: all
Security: Bearer

## Query parameters:

  - `useLegacyCategorisation` (boolean)
    Flag whether to use the latest or legacy categorisation service

  - `confidenceFloor` (number)
    Value from 0.0 to 1.0 which will return transactions as uncategorised if the category confidence is below this value

## Request fields (application/json-patch+json):

  - `referenceId` (string, required)
    Unique identifier for the categorisation request

  - `countryCode` (string, required)
    Country code for the account of the transactions

  - `currencyCode` (string, required)
    Currency code for the transactions, currently supported codes are GBP and USD.

  - `transactions` (array,null)
    Transaction data. Maximum limit for the number of transactions is 5000.

  - `transactions.transactionId` (string, required)
    Unique transaction id assigned by the provider

  - `transactions.description` (string, required)
    A description line for the transaction

  - `transactions.amount` (number, required)
    The quantity of money

  - `transactions.creditDebitIndicator` (string, required)
    Enum: "Credit", "Debit"

  - `transactions.status` (string, required)
    Enum: "Pending", "Booked"

  - `transactions.bookingDate` (string, required)
    ISO8601 formatted date string containing the date the transaction is expected to be settled(or did settle)

## Response 200 fields (application/json):

  - `referenceId` (string,null)
    Unique identifier for the categorisation request

  - `countryCode` (string,null)
    Country code for the account of the transactions

  - `currencyCode` (string,null)
    Currency code for the transactions, currently supported codes are GBP and USD.

  - `transactions` (array,null)

  - `transactions.transactionId` (string, required)
    Unique transaction id assigned by the provider

  - `transactions.description` (string, required)
    A description line for the transaction

  - `transactions.amount` (number, required)
    The quantity of money

  - `transactions.creditDebitIndicator` (string, required)
    Enum: "Credit", "Debit"

  - `transactions.status` (string, required)
    Enum: "Pending", "Booked"

  - `transactions.bookingDate` (string, required)
    ISO8601 formatted date string containing the date the transaction is expected to be settled(or did settle)

  - `transactions.enrichedData` (object)

  - `transactions.enrichedData.category` (object)

  - `transactions.enrichedData.category.id` (integer)

  - `transactions.enrichedData.category.name` (string,null)

  - `transactions.enrichedData.category.confidence` (number)
    Confidence score range: 0.0 - 1.0

  - `transactions.enrichedData.class` (object)

  - `transactions.enrichedData.predictedMerchantName` (string,null)

## Response 400 fields (application/json):

  - `code` (string,null)
    Error code.

  - `description` (string,null)
    Error message.

  - `details` (string,null)
    Error details.

  - `correlationId` (string,null)
    User transaction tracking Id

## Response 403 fields (application/json):

  - `code` (string,null)
    Error code.

  - `description` (string,null)
    Error message.

  - `details` (string,null)
    Error details.

  - `correlationId` (string,null)
    User transaction tracking Id

## Response 500 fields (application/json):

  - `code` (string,null)
    Error code.

  - `description` (string,null)
    Error message.

  - `details` (string,null)
    Error details.

  - `correlationId` (string,null)
    User transaction tracking Id