Guide

Transaction enrichment API

One descriptor in. Display-ready merchant fields, confidence, signals, and warnings out.

Answer-first summary

POST /v1/enrich is a narrow API for enriching one safe transaction descriptor at a time. It rejects sensitive input before parsing, matching, queueing, logging, or third-party use.

Raw descriptor example

POST /v1/enrich

{
  "raw_description": "SQ *JOES COFFEE 0421 TORONTO",
  "amount": 6.75,
  "currency": "CAD",
  "country": "CA",
  "date": "2026-05-22",
  "mcc": "5814"
}

Key response fields

The response fields include display_name, category, confidence, signals, warnings, processor hints, location hints, recurrence hints, and reviewed logo variants when evidence supports them.

When to use

Use TxnKit when your app already has transaction descriptors and needs a focused enrichment API for visible feed quality.

When not to use

Do not submit full statements, card numbers, account numbers, bank credentials, customer names, emails, phone numbers, addresses, or customer PII.