---
title: "Submit enrichment feedback"
method: POST
path: "/feedback"
tags: ["Feedback"]
---

# Submit enrichment feedback

`POST /feedback`

Submit feedback about enrichment results returned by Genie.

Using this endpoint you can suggest corrections to an enrichment result or provide information for queries where Genie has not returned a result.

## Request body

- GenieFeedback
  - `feedback_type` 'ENRICHMENT_CORRECTION' | 'MISSING_ENRICHMENT', required — The type of feedback: - `ENRICHMENT_CORRECTION` → You would like to suggest a correction to one or more aspects of a Genie enrichment result. - `MISSING_ENRICHMENT` → You would like to suggest enrichment details for a query where Genie has not returned a result.
  - `query` GenieSearchQueryItem, required
    - `id` string — A unique correlation ID for the query to help you to find the corresponding result in the response data.
    - `description` string — The transaction description. This should be the full description as provided by the bank / transaction source.
    - `_connection` 'conn_cjgaawozb000001nyd111xixr' | 'conn_cjgaaqcna000001ldwof8tvj0' | 'conn_cjgaatd57000001pe1t1z0iy9' | 'conn_ck5rhsdbv0000ftx1bmdu9zas' | 'conn_cjgaac5at000001qi2yw8ftil' | 'conn_ckydkmy3r000009mde2sx2i4d' | 'conn_cjgab1c8e000001pmyxrkhova' | 'conn_cjgab6fis000001qsytf1semy' | 'conn_cjgaaozdo000001mrnqmkl1m0' — The Akahu connection identifier corresponding to the bank from which the transaction description was sourced. It is strongly recommended to include this parameter to ensure best results. The following connection identifiers are available: - ANZ: `conn_cjgaawozb000001nyd111xixr` - ASB: `conn_cjgaaqcna000001ldwof8tvj0` - BNZ: `conn_cjgaatd57000001pe1t1z0iy9` - Heartland: `conn_ck5rhsdbv0000ftx1bmdu9zas` - Kiwibank: `conn_cjgaac5at000001qi2yw8ftil` - Rabobank: `conn_ckydkmy3r000009mde2sx2i4d` - The Cooperative Bank: `conn_cjgab1c8e000001pmyxrkhova` - TSB: `conn_cjgab6fis000001qsytf1semy` - Westpac: `conn_cjgaaozdo000001mrnqmkl1m0`
    - `amount` number — Transaction amount (+ for credit, - for debit).
    - `direction` 'DEBIT' | 'CREDIT' — Whether the transaction is a debit or credit.
    - `type` 'CARD' | 'DIRECT DEBIT' | 'PAYMENT' | 'STANDING ORDER' — The type of transaction this query relates to.
    - `meta` object
      - `other_account` string — The payee bank account number.
      - `merchant_name` string — The merchant's name. If provided alongside `merchant_city` and `merchant_country`, these values will be used as additional data points for enrichment.
      - `merchant_city` string — The merchant's city.
      - `merchant_country` string — The merchant's country.
  - `match_reference` string — _Required for `ENRICHMENT_CORRECTION` feedback._ The match reference returned by Genie for the query that you are providing feedback on.
  - `_merchant` string — _Required for `ENRICHMENT_CORRECTION` feedback if Genie returned a merchant as part of the result._ The merchant identifier returned by Genie.
  - `_outlet` string — _Required for `ENRICHMENT_CORRECTION` feedback if Genie returned an outlet as part of the result._ The outlet identifier returned by Genie.
  - `_category` string — _Required for `ENRICHMENT_CORRECTION` feedback._ The NZFCC category code returned by Genie.
  - `comment` string, required — Free-text field for the content of your feedback.

## Response `200`

Success

- object
  - `success` true, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `429` — Rate Limiting
- `500` — Internal Server Error

---

[API](https://skmtc.dev/akahu/apis/akahu-enduring-api.md) · [All operations](https://skmtc.dev/akahu/apis/akahu-enduring-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/akahu/akahu-enduring-api/revisions/b2de9915920d/schema)