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

# Search transactions

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

## Request

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

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.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)