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

# List variance report

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

Use this endpoint to retrieve a paginated variance analysis report 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 variance analysis report

- ListVarianceReportResponse — Cursor-paginated variance analysis report
  - `items` VarianceReportRowResponse[] — List of variance report rows
    - `sourceId` string — The identifier of the reconciliation source
    - `currency` string — The currency code (ISO 4217)
    - `feeScheduleId` string — Identifier of the fee schedule associated with this variance row
    - `feeScheduleName` string — Human-readable name of the fee schedule
    - `fee_type` string — The type of fee
    - `totalExpected` string — The total expected amount
    - `totalActual` string — The total actual amount
    - `netVariance` string — The net variance between expected and actual
    - `variancePct` string — The variance as a percentage
  - `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)