---
title: "List matched transactions report"
method: GET
path: "/v1/reports/contexts/{contextId}/matched"
tags: ["Reporting"]
---

# List matched transactions report

`GET /v1/reports/contexts/{contextId}/matched`

Use this endpoint to retrieve a paginated list of matched transactions for a specific context and date range. The response uses cursor-based pagination.

## Path parameters

- `contextId` string, uuid, required

## Query parameters

- `date_from` string, date, required
- `date_to` string, date, required
- `source_id` string
- `cursor` string
- `limit` integer
- `sort_order` 'asc' | 'desc'

## Headers

- `X-Request-Id` string

## Response `200`

Paginated list of matched transactions

- ListMatchedReportResponse — Cursor-paginated list of matched transactions
  - `items` MatchedItemResponse[] — List of matched transaction items
    - `transactionId` string — The unique identifier of the transaction
    - `matchGroupId` string — The identifier of the match group this transaction belongs to
    - `sourceId` string — The identifier of the reconciliation source
    - `amount` string — The transaction amount
    - `currency` string — The currency code (ISO 4217)
    - `date` string, date — The transaction date
  - `pagination` CursorPagination — Cursor-based pagination metadata for report endpoints. Both fields are opaque base64-encoded JSON cursor tokens; treat them as strings and pass them back unchanged in the `cursor` query parameter to navigate. An empty string means there is no further page in that direction.
    - `next` string — Opaque cursor for the next page. Empty when there are no more results.
    - `prev` string — Opaque cursor for the previous page. Empty when on the first page.

## 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.
- `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/versions/25daba385532/schema)