---
title: "Ignore a transaction"
method: POST
path: "/v1/imports/contexts/{contextId}/transactions/{transactionId}/ignore"
tags: ["Ingestion"]
---

# Ignore a transaction

`POST /v1/imports/contexts/{contextId}/transactions/{transactionId}/ignore`

## Request

- Base URL: `https://identity.sandbox.lerian.net`
- URL: `https://identity.sandbox.lerian.net/v1/imports/contexts/{contextId}/transactions/{transactionId}/ignore`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/lerian/apis/identity-plugin/docs/v1/imports/contexts/:contextId/transactions/:transactionId/ignore/post.ts> (a function with typed inputs; its response is checked against the schema)

Use this endpoint to mark a transaction as "Do Not Match" with a required reason. Only UNMATCHED transactions can be ignored.

## Path parameters

- `contextId` string, uuid, required
- `transactionId` string, required

## Headers

- `X-Request-Id` string
- `X-Idempotency-Key` string

## Request body

- IgnoreTransactionRequest: Ignore transaction request
  - `reason` string, required: Reason for ignoring the transaction

## Response `200`

Indicates that the request was successful and the response contains the expected data.

The response includes the `X-Idempotency-Replayed` header.

If the value is false, the request was just processed. If the value is true, the response is a replay of a previously processed request.

See [Retries and idempotency](/en/reference/retries-idempotency) for more details.

- IgnoreTransactionResponse: Ignore transaction response
  - `amount` string: Transaction amount as string
  - `contextId` string: Context ID this transaction belongs to
  - `createdAt` string: Creation timestamp in RFC3339 format
  - `currency` string: Currency code
  - `date` string: Transaction date in RFC3339 format
  - `description` string: Description of the transaction
  - `externalId` string: External identifier from the source system
  - `extractionStatus` 'PENDING' | 'EXTRACTED' | 'FAILED': Extraction status
  - `id` string: Unique identifier for the transaction
  - `jobId` string: Job ID that ingested this transaction
  - `sourceId` string: Source ID this transaction belongs to
  - `status` 'PENDING' | 'MATCHED' | 'UNMATCHED': Current matching status

## Other responses

- `400`: The request contains invalid parameters or payload.
- `401`: The request lacks valid authentication credentials.
- `403`: You do not have permission to access this resource.
- `404`: The requested resource was not found.
- `409`: Transaction already matched/ignored or idempotency conflict
- `500`: An unexpected error occurred on the server.

---

[API](https://skmtc.dev/lerian/apis/identity-plugin.md) - [All operations](https://skmtc.dev/lerian/apis/identity-plugin/llms.txt) - [OpenAPI document](https://skmtc.dev/lerian/apis/identity-plugin/revisions/25daba385532?raw)