Ignore a transaction
Use this endpoint to mark a transaction as “Do Not Match” with a required reason. Only UNMATCHED transactions can be ignored.
Authorizations
Bearer token authentication (format: "Bearer {token}")
Headers
A unique identifier for tracing the request across services.
Optional idempotency key for safe retries. Matcher reads the key only from this header, and only when you send one. A request that carries a key only in X-Idempotency-Key or Idempotency-Key is refused with 400 (MTCH-0015), and nothing is processed. If the same key is sent again and the original request was already processed, the stored response is returned with X-Idempotency-Replayed: true. A malformed key returns 400, a key whose first request is still in progress returns 409, and an idempotency storage failure returns 500. These refusals are problem documents.
Path Parameters
The unique identifier of the reconciliation context. Context ID
The unique identifier of the transaction. Transaction ID
Body
Ignore transaction request
Reason for ignoring the transaction
1"Duplicate entry - already processed manually"
Response
Indicates that the request was successful and the response contains the expected data.
Transaction amount as a decimal string in the transaction currency (precision preserved verbatim; never a float)
"1000.50"
Reconciliation context this transaction belongs to
"550e8400-e29b-41d4-a716-446655440000"
Creation timestamp (RFC 3339)
"2025-01-15T10:30:00Z"
ISO 4217 currency code of the amount
"USD"
Transaction value date (RFC 3339)
"2025-01-15T00:00:00Z"
Read-only: the duplicate-key value this row was imported under, derived from the source's duplicate key declaration at import time. A source can change that declaration later, so this is the only place that says which identity THIS row carries. Prefixed v1 when the key spells out the fields it was derived from, v1h when those fields were hashed because the spelled-out key was too long to index.
"v1|external_id=9:TXN-12345"
External identifier carried from the source system
"TXN-12345"
Field-extraction status: PENDING (queued), COMPLETE (fields parsed), FAILED (extraction error)
PENDING, COMPLETE, FAILED "COMPLETE"
Unique identifier for the transaction
"550e8400-e29b-41d4-a716-446655440000"
Ingestion job that produced this transaction
"550e8400-e29b-41d4-a716-446655440000"
Source this transaction belongs to
"550e8400-e29b-41d4-a716-446655440000"
Matching status: UNMATCHED (no match found), MATCHED (reconciled), IGNORED (excluded from reconciliation by an operator), PENDING_REVIEW (imported under the blank-external-id review policy and awaiting an operator decision)
UNMATCHED, MATCHED, IGNORED, PENDING_REVIEW "UNMATCHED"
Free-text description carried from the source
"Wire transfer from ABC Corp"
Normalized source metadata: unmapped source columns the engine projects into composite match keys and FX-conversion inputs (e.g. counterparty, bank_transaction_code, fx_rate). Arbitrary key/value, tenant-scoped to the caller's own data.

