List clearing positions

Lists the settlement institution’s (IF Liquidante) clearing positions for the request tenant: the SLC0001 (clearing net-position notice) net position per participant by stage (PREVIEW/FINAL). This is the clearing PREVIEW/POSITION notice only — it carries NO deposit window or action. Filters: referenceDate (YYYY-MM-DD), cycle, stage. Offset/limit pagination WITHOUT a total count. RBAC: clearing:read; tenant is always derived from the validated request identity.

GET /v1/clearing/positions

List clearing positions

cURL

curl --request GET \
  --url https://slc.sandbox.lerian.net/v1/clearing/positions \
  --header 'Authorization: Bearer <token>'

200

{
  "items": [
    {
      "counterparties": [
        {
          "amountCents": 123,
          "counterpartyIspb": "<string>",
          "direction": "<string>"
        }
      ],
      "currency": "<string>",
      "cycle": "<string>",
      "participantIspb": "<string>",
      "positionCents": 123,
      "receivedAt": "<string>",
      "referenceDate": "<string>",
      "stage": "<string>",
      "sourceMessageId": "<string>"
    }
  ],
  "pagination": {
    "hasNext": true,
    "page": 123,
    "perPage": 123
  }
}

Authorizations

Authorization · string · header · required

JWT bearer token issued by the identity provider.

Query Parameters

referenceDate · string

Filter by settlement date (YYYY-MM-DD).

Example:

"2026-06-15"

cycle · string

Filter by settlement cycle.

Example:

"07:50"

stage · string

Filter by clearing stage (PREVIEW or FINAL).

Example:

"FINAL"

limit · string

Page size (default 50, max 500). A non-positive/non-numeric value is rejected with 400.

Example:

"50"

offset · string

Row offset (default 0). A negative/non-numeric value is rejected with 400.

Example:

"0"

Response

200

application/json

OK

items · object[] | null · required

Clearing positions in this page.

Show child attributes

pagination · object · required

Pagination metadata for this page.

Show child attributes