---
title: "Search transactions"
method: GET
path: "/v1/imports/contexts/{contextId}/transactions/search"
tags: ["Ingestion"]
---

# Search transactions

`GET /v1/imports/contexts/{contextId}/transactions/search`

Use this endpoint to search transactions within a reconciliation context. Supports free-text search, amount range filters, date filters, and status filters with offset-based pagination.

## Path parameters

- `contextId` string, required

## Query parameters

- `q` string
- `amount_min` string
- `amount_max` string
- `date_from` string, date-time
- `date_to` string, date-time
- `reference` string
- `currency` string
- `source_id` string
- `status` 'UNMATCHED' | 'MATCHED' | 'IGNORED' | 'PENDING_REVIEW'
- `limit` integer
- `offset` integer

## Headers

- `X-Request-Id` string

## Response `200`

Search results with offset pagination

- SearchTransactionsResponse — Search results for transactions with offset pagination
  - `items` TransactionResponse[]
    - `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
  - `total` integer — Total number of matching transactions
  - `limit` integer — Maximum items per page
  - `offset` integer — Number of items skipped

## 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.
- `500` — An unexpected error occurred on the server.

---

[API](https://skmtc.net/lerian/apis/identity-plugin.md) · [All operations](https://skmtc.net/lerian/apis/identity-plugin/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lerian/identity-plugin/revisions/25daba385532/schema)