> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar posiciones de compensación

> Lista las posiciones de compensación de la institución liquidadora (IF Liquidante — el banco que mueve el dinero en el STR en nombre de las demás) para el tenant de la solicitud: la posición neta SLC0001 por participante por etapa (PREVIEW o FINAL). Este es solo el aviso de vista previa o posición de compensación — no lleva ventana ni acción de depósito (la solicitud de depósito es un flujo LDL0021 / clearing.deposit_required aparte). Filtros: reference_date (YYYY-MM-DD), cycle, stage. Paginación offset/limit sin recuento total. RBAC: clearing:read. El tenant siempre se deriva de la identidad validada de la solicitud.



## OpenAPI

````yaml es/openapi/v3-current/slc.yaml get /v1/clearing/positions
openapi: 3.0.3
info:
  title: Lerian SLC API
  description: >-
    API de Lerian SLC — el rail del lado del participante que conecta la
    institución con la liquidación de tarjetas por neto diferido SLC de Núclea.
    Cubre la admisión y el ciclo de vida de las operaciones de liquidación, las
    posiciones de compensación, el registro de participantes y arreglos, la
    recuperación de transmisión y la conectividad con Núclea, la importación de
    clave de firma BYOK Modelo A y los webhooks con alcance al tenant.
  version: v1.0.0
servers:
  - url: https://slc.sandbox.lerian.net
security: []
tags:
  - name: Admin
    description: Configuración del tenant y administración de cartas muertas.
  - name: Clearing
    description: >-
      Posiciones de compensación por neto diferido de la institución
      liquidadora.
  - name: Connectivity
    description: >-
      Drenajes de recuperación de transmisión, retransmisión y sondas de
      conectividad con Núclea.
  - name: Operations
    description: >-
      Admisión, ciclo de vida e historial de estados de las operaciones de
      liquidación.
  - name: Participants
    description: Registro de participantes del tenant.
  - name: Arrangements
    description: Arreglos de tarjeta y esquema por participante.
  - name: SigningKey
    description: Importación de clave de firma BYOK Modelo A para la firma de mensajes.
  - name: Webhooks
    description: Suscripciones de webhook con alcance al tenant, entregas y reenvío.
paths:
  /v1/clearing/positions:
    get:
      tags:
        - Clearing
      summary: Listar posiciones de compensación
      description: >-
        Lista las posiciones de compensación de la institución liquidadora (IF
        Liquidante — el banco que mueve el dinero en el STR en nombre de las
        demás) para el tenant de la solicitud: la posición neta SLC0001 por
        participante por etapa (PREVIEW o FINAL). Este es solo el aviso de vista
        previa o posición de compensación — no lleva ventana ni acción de
        depósito (la solicitud de depósito es un flujo LDL0021 /
        clearing.deposit_required aparte). Filtros: reference_date (YYYY-MM-DD),
        cycle, stage. Paginación offset/limit sin recuento total. RBAC:
        clearing:read. El tenant siempre se deriva de la identidad validada de
        la solicitud.
      operationId: listClearingPositions
      parameters:
        - description: Filter by settlement date (YYYY-MM-DD)
          in: query
          name: reference_date
          schema:
            type: string
        - description: Filter by settlement cycle
          in: query
          name: cycle
          schema:
            type: string
        - description: Filter by clearing stage (PREVIEW or FINAL)
          in: query
          name: stage
          schema:
            type: string
        - description: Page size (default 50, max 500)
          in: query
          name: limit
          schema:
            type: integer
        - description: Row offset (default 0)
          in: query
          name: offset
          schema:
            type: integer
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/http.listClearingPositionsResponse'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/http.ErrorResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/http.ErrorResponse'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/http.ErrorResponse'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/http.ErrorResponse'
      security:
        - BearerAuth: []
components:
  schemas:
    http.listClearingPositionsResponse:
      properties:
        items:
          items:
            $ref: '#/components/schemas/http.clearingPositionResponse'
          type: array
        pagination:
          $ref: '#/components/schemas/http.clearingPaginationMeta'
      type: object
    http.ErrorResponse:
      properties:
        code:
          type: string
        details:
          additionalProperties: {}
          type: object
        message:
          type: string
        title:
          type: string
      type: object
    http.clearingPositionResponse:
      properties:
        counterparties:
          items:
            $ref: '#/components/schemas/http.counterpartyResponse'
          type: array
        currency:
          type: string
        cycle:
          type: string
        participantIspb:
          type: string
        positionCents:
          type: integer
        receivedAt:
          type: string
        referenceDate:
          type: string
        sourceMessageId:
          type: string
        stage:
          type: string
      type: object
    http.clearingPaginationMeta:
      properties:
        hasNext:
          type: boolean
        page:
          type: integer
        perPage:
          type: integer
      type: object
    http.counterpartyResponse:
      properties:
        amountCents:
          type: integer
        counterpartyIspb:
          type: string
        direction:
          type: string
      type: object
  securitySchemes:
    BearerAuth:
      description: 'Bearer token authentication (format: "Bearer {token}")'
      in: header
      name: Authorization
      type: apiKey

````