List open items

Returns a cursor-paginated list of open-item residual ledger entries for a reconciliation context — the carried, partially-filled, and aged obligations the context carries forward across match runs. These are structurally distinct from never-matched (UNMATCHED) transactions. Optionally narrowed by lifecycle status. The listing is readable regardless of context status.

GET /v1/matching/contexts/{contextId}/open-items

List open items

cURL

curl --request GET \
  --url https://matcher.sandbox.lerian.net/v1/matching/contexts/{contextId}/open-items \
  --header 'Authorization: Bearer <token>'

200

{
  "hasMore": true,
  "items": [
    {
      "ageDays": 1,
      "contextId": "<string>",
      "createdAt": "<string>",
      "currency": "<string>",
      "expectedBalance": "<string>",
      "firstSeenAt": "<string>",
      "id": "<string>",
      "identityKey": "<string>",
      "lastActivityAt": "<string>",
      "runningBalance": "<string>",
      "status": "<string>",
      "updatedAt": "<string>",
      "obligationDate": "<string>",
      "runId": "<string>",
      "transactionId": "<string>"
    }
  ],
  "limit": 100,
  "nextCursor": "<string>",
  "prevCursor": "<string>"
}

Authorizations

Authorization · string · header · required

Bearer token authentication (format: "Bearer {token}")

Path Parameters

contextId · string<uuid> · required

Reconciliation context ID

Query Parameters

status · enum<string>

Filter by open-item lifecycle status

Available options: OPEN, PARTIALLY_CLEARED, CLEARED, AGED

limit · integer<int64> · default: 20

Maximum number of records to return

Required range: 1 <= x <= 200

cursor · string

Opaque pagination cursor

sort_by · enum<string>

Field to sort by. Defaults to id (stable insertion order). ageDays sorts by aging anchor (oldest residuals first when descending)

Available options: ageDays, runningBalance, obligationDate

sort_order · enum<string>

Sort order

Available options: asc, desc

Response

200

application/json

OK

hasMore · boolean · required

Example:

true

items · object[] | null · required

Page of open items

Maximum array length: 200

Show child attributes

limit · integer<int64> · required

Required range: 1 <= x <= 200

Example:

20

nextCursor · string

Example:

"eyJpZCI6IjEyMyJ9"

prevCursor · string

Example:

"eyJpZCI6IjEyMiJ9"