---
title: "List reconciliation contexts"
method: GET
path: "/v1/contexts"
tags: ["Configuration Contexts"]
---

# List reconciliation contexts

`GET /v1/contexts`

Use this endpoint to retrieve all reconciliation contexts.  

Supports filtering by type and status and uses cursor-based pagination.

## Query parameters

- `limit` integer
- `cursor` string
- `type` '1:1' | '1:N' | 'N:M'
- `status` 'DRAFT' | 'ACTIVE' | 'PAUSED' | 'ARCHIVED'

## Headers

- `X-Request-Id` string

## Response `200`

List of contexts with cursor pagination

- ListContextsResponse — Cursor-paginated list of reconciliation contexts
  - `items` ReconciliationContextResponse[] — List of reconciliation contexts
    - `id` string — Unique identifier for the context
    - `tenantId` string — Tenant ID this context belongs to
    - `name` string — Name of the reconciliation context
    - `type` '1:1' | '1:N' | 'N:M' — Reconciliation topology type
    - `interval` string — Execution interval
    - `status` 'DRAFT' | 'ACTIVE' | 'PAUSED' | 'ARCHIVED' — Current status of the context
    - `feeToleranceAbs` string — Absolute fee tolerance amount
    - `feeTolerancePct` string — Percentage fee tolerance
    - `feeNormalization` 'NET' | 'GROSS' — Fee normalization mode
    - `autoMatchOnUpload` boolean — Whether matching triggers automatically after file upload
    - `createdAt` string — Creation timestamp in RFC3339 format
    - `updatedAt` string — Last update timestamp in RFC3339 format
  - `nextCursor` string
  - `limit` integer
  - `prevCursor` string
  - `hasMore` boolean

## Other responses

- `400` — Invalid query parameters
- `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/versions/25daba385532/schema)