---
title: "Enrichment"
method: POST
path: "/transactions/categorisation"
tags: ["Data Plus"]
---

# Enrichment

`POST /transactions/categorisation`

Trigger categorisation for transactions provided in the request.

## Request body

- object
  - `countryCode` string, required — __Mandatory__. Two-letter country code in ISO 3166-1 alpha-2 format (e.g. GB)
  - `categorisationType` string, required — __Mandatory__. Allowed values are `consumer` and `business`.
  - `transactions` object[], required
    - `id` string, required — __Mandatory__. A globally unique transaction ID.
    - `date` string, required — __Mandatory__. Transaction date in ISO 8601 format (eg. 2025-01-01T12:59:59.999Z)
    - `amount` object, required
      - `value` integer, required — __Mandatory__. Transaction money amount in cents (or equivalent). Positive amount implies money in, negative amount implies money out.
      - `currency` string, required — __Mandatory__. Transaction currency.
    - `merchant` object
      - `mcc` string — __Optional__. Merchant Category Code (MCC) according to ISO 18245
    - `description` string, required — __Mandatory__. Transaction-specific description.
    - `countryCode` string, required — __Mandatory__. Transaction-specific two-letter country code in ISO 3166-1 alpha-2 format (e.g. GB)

## Response `201`

Created

## Other responses

- `400` — Validation Error
- `401` — Authentication Error
- `500` — Unexpected Error

---

[API](https://skmtc.net/yapily/apis/yapily-api.md) · [All operations](https://skmtc.net/yapily/apis/yapily-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/yapily/yapily-api/versions/a8ca54f9eb9f/schema)