Sign in

v1

latestOpenAPI 3.1.02026-07-263644911022.4 KB
Ingestion

Ignore a transaction

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

post/v1/imports/contexts/{contextId}/transactions/{transactionId}/ignore

Path parameters

contextIdstring uuid required

The unique identifier of the reconciliation context.

transactionIdstring required

The unique identifier of the transaction.

Headers

X-Request-Idstring

A unique identifier for tracing the request across services.

X-Idempotency-Keystring

Optional idempotency key for safe retries. Also accepts Idempotency-Key as an alternative header name. If the same key is sent again and the original request was already processed, the cached response is returned with X-Idempotency-Replayed: true.

See Retries and idempotency for details.

Request body

reasonstring required

Reason for ignoring the transaction

Example request

{
  "reason": "Duplicate entry - already processed manually"
}

Response

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 for more details.

amountstring

Transaction amount as string

contextIdstring

Context ID this transaction belongs to

createdAtstring

Creation timestamp in RFC3339 format

currencystring

Currency code

datestring

Transaction date in RFC3339 format

descriptionstring

Description of the transaction

externalIdstring

External identifier from the source system

extractionStatus'PENDING' | 'EXTRACTED' | 'FAILED'

Extraction status

idstring

Unique identifier for the transaction

jobIdstring

Job ID that ingested this transaction

sourceIdstring

Source ID this transaction belongs to

status'PENDING' | 'MATCHED' | 'UNMATCHED'

Current matching status

Example response

{
  "amount": "1000.50",
  "contextId": "019c96a0-10a0-72d2-9fb0-2b7de8093182",
  "createdAt": "2025-01-15T10:30:00.000Z",
  "currency": "BRL",
  "date": "2025-01-15T00:00:00.000Z",
  "description": "Wire transfer from ABC Corp",
  "externalId": "TXN-12345",
  "extractionStatus": "EXTRACTED",
  "id": "019c96a0-10ce-75fc-a273-dc799079a99c",
  "jobId": "019c96a0-10ce-75fc-a273-dc799079a99c",
  "sourceId": "019c96a0-108c-7a74-8e31-3789daffe1ed",
  "status": "PENDING"
}