> ## 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.

# Look up an operation by NUliquid

> Resolves an operation by its 21-position NUliquid via a local lookup. The format is validated first: a malformed NUliquid returns 422, an absent one returns 404.



## OpenAPI

````yaml en/openapi/v3-current/slc.yaml get /v1/operations/nuliquid/{nuliquid}
openapi: 3.0.3
info:
  title: Lerian SLC API
  description: >-
    API for Lerian SLC — the participant-side rail that connects the institution
    to Núclea's SLC deferred-net card settlement. It covers settlement-operation
    intake and lifecycle, clearing positions, the participant and arrangement
    registry, transmission recovery and connectivity to Núclea, BYOK Model-A
    signing-key import, and tenant-scoped webhooks.
  version: v1.0.0
servers:
  - url: https://slc.sandbox.lerian.net
security: []
tags:
  - name: Admin
    description: Tenant configuration and dead-letter administration.
  - name: Clearing
    description: Deferred-net clearing positions for the settlement institution.
  - name: Connectivity
    description: >-
      Transmission recovery drains, retransmission, and connectivity probes to
      Núclea.
  - name: Operations
    description: Settlement operation intake, lifecycle, and state history.
  - name: Participants
    description: Participant registry for the tenant.
  - name: Arrangements
    description: Card and scheme arrangements per participant.
  - name: SigningKey
    description: BYOK Model-A signing-key import for message signing.
  - name: Webhooks
    description: Tenant-scoped webhook subscriptions, deliveries, and replay.
paths:
  /v1/operations/nuliquid/{nuliquid}:
    get:
      tags:
        - Operations
      summary: Look up an operation by NUliquid
      description: >-
        Resolves an operation by its 21-position NUliquid via a local lookup.
        The format is validated first: a malformed NUliquid returns 422, an
        absent one returns 404.
      operationId: getOperationByNUliquid
      parameters:
        - description: 'NUliquid (21 positions: AAAAMMDD + 13 digits)'
          in: path
          name: nuliquid
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/http.OperationDetailResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/http.ErrorResponse'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/http.ErrorResponse'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/http.ErrorResponse'
        '422':
          description: Unprocessable Entity
          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.OperationDetailResponse:
      properties:
        arrangementCode:
          type: string
        aslcType:
          type: string
        batchId:
          type: string
        cancellationTargetOperationId:
          description: >-
            CancellationTargetOperationId is the id of the movement a
            Núclea-coordinated

            CANCELLATION targets (E-5.3). Populated ONLY on the CANCELLATION
            path (null for

            every other type), so a consumer can correlate a cancellation to the
            operation it

            cancels. Mirrors the optional SettlementIfISPB projection (nullable,
            always present).
          type: string
        createdAt:
          type: string
        creditorIspb:
          type: string
        currency:
          type: string
        domicileIfIspb:
          type: string
        dueDate:
          type: string
        eslcErrors:
          items:
            type: string
          type: array
        externalId:
          type: string
        id:
          type: string
        installmentNumber:
          type: integer
        installments:
          type: integer
        intakeMode:
          type: string
        lastError:
          type: string
        nuliquid:
          type: string
        operationType:
          type: string
        participantId:
          type: string
        participantRole:
          type: string
        reasonCategory:
          type: string
        settlementIfIspb:
          type: string
        state:
          type: string
        stuckSince:
          type: string
        updatedAt:
          type: string
        value:
          type: integer
        waitingFor:
          description: >-
            Recoverability diagnostics: the operator distinguishes an external
            wait (waitingFor set → use reconcile) from an internal block
            (waitingFor nil + stuckSince set → use advance/requeue); lastError
            carries the most recent recorded Núclea error.
          type: string
      type: object
    http.ErrorResponse:
      properties:
        code:
          type: string
        details:
          additionalProperties: {}
          type: object
        message:
          type: string
        title:
          type: string
      type: object
  securitySchemes:
    BearerAuth:
      description: 'Bearer token authentication (format: "Bearer {token}")'
      in: header
      name: Authorization
      type: apiKey

````