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

# Leer el resultado de la consulta de extrato de reservas STR0014 (modo mensaje)

> Lee el resultado de una consulta de extrato de cuenta de reservas STR0014 enviada previamente por su id de correlación. Devuelve PENDING hasta que llega la respuesta STR0014R1, luego los saldos de apertura/cierre y el grupo de asientos liquidados que envió BACEN, de forma literal. Devuelve 422 cuando la respuesta requiere recuperación en modo archivo (BACEN devolvió metadatos de archivo o la ventana excedió el tope de 200 asientos del modo mensaje); la lista de asientos nunca se trunca de forma silenciosa.



## OpenAPI

````yaml es/openapi/v3-current/spb.yaml get /v1/str/reserve-statement-queries/{id}
openapi: 3.1.0
info:
  contact:
    email: contact@lerian.studio
    name: Lerian Studio
    url: https://lerian.studio
  description: >-
    Interfaz OpenAPI 3.1 de Lerian SPB, la integración directa entre la
    institución y el Sistema de Pagos Brasileño (SPB) sobre la Red del Sistema
    Financiero Nacional (RSFN). Cubre el Sistema de Transferencia de Reservas
    (STR): registro de mensajes y catálogo de capacidades, ciclo de vida de las
    operaciones (transferencias bancarias, repasses IBS, transferencias de
    liquidez, devoluciones y cancelaciones), consultas de cuenta de reservas y
    de horarios, gobernanza de alçada, conciliación y entrega de eventos.
  license:
    name: Lerian Studio General License
  title: Lerian SPB API
  version: 1.0.0
servers:
  - url: https://spb.sandbox.lerian.net
security: []
tags:
  - description: >-
      Rastros inmutables de registros de auditoría para operaciones STR y
      eventos de ciclo de vida.
    name: Audit
  - description: >-
      Catálogo de capacidades STR que describe los tipos de mensaje admitidos y
      sus restricciones.
    name: Capabilities
  - description: >-
      Inventario de certificados ICP-Brasil con rotación y activación
      recargables en caliente.
    name: Certificates
  - description: >-
      Cola de aprobación maker-checker para emisiones retenidas por encima de su
      banda de alçada: listar pendientes, firmar (aprobar) y denegar.
    name: EmissionApprovals
  - description: >-
      Registros de entrega de eventos por webhook con control de reintentos para
      despachos fallidos.
    name: EventDeliveries
  - description: >-
      Catálogo de eventos de operación que enumera los tipos de evento de
      dominio emitidos.
    name: Events
  - description: >-
      Registro de avisos entrantes de la familia GEN (GEN0001 eco de
      conectividad, GEN0004 error de transmisión, GEN0005 aviso administrativo).
    name: GenNotices
  - description: >-
      Gobernanza de alçada del SPB: la tabla de bandas de valor y los requisitos
      de firma por tipo de mensaje, recargados en caliente en tiempo de
      ejecución.
    name: Governance
  - description: >-
      Estado crudo de los mensajes STR: listar los mensajes y leer un mensaje
      individual por NUOp.
    name: Messages
  - description: Resúmenes y métricas operativas agregadas de las operaciones STR.
    name: OperationalIntelligence
  - description: >-
      Ciclo de vida de las operaciones STR para transferencias bancarias y
      repasses IBS, incluyendo devoluciones y cancelaciones.
    name: Operations
  - description: >-
      Estado de disponibilidad del servicio que abarca las autopruebas de
      arranque y la salud de las dependencias.
    name: Readiness
  - description: >-
      Casos de conciliación y las acciones que resuelven las discrepancias de
      operación.
    name: Reconciliation
  - description: >-
      Suite de reportes STR: reportes agregados síncronos por rango de fechas
      (movimiento financiero, transacciones rechazadas, volumetria) sobre el
      propio registro de transmisión de Lerian SPB.
    name: Reports
  - description: >-
      Consultas de saldo de cuenta de reservas STR0013 y de extrato STR0014
      (modo mensaje) y sus resultados asíncronos.
    name: ReserveQueries
  - description: >-
      Lista de responsáveis del participante GEN0019: actualizaciones de
      reemplazo total anunciadas a BACEN.
    name: Responsibles
  - description: >-
      Programación de ventanas de operación del STR que rige cuándo pueden
      enviarse las operaciones.
    name: Schedule
  - description: >-
      Consultas de horarios STR0001 de parte única (consulta de horários do STR)
      y sus resultados de grilla STR0001R1 asíncronos.
    name: ScheduleQueries
  - description: >-
      Ajustes de configuración del SPB en tiempo de ejecución para la
      integración STR.
    name: Settings
  - description: Registro y gestión de endpoints de webhook para la entrega de eventos.
    name: Webhooks
  - description: >-
      Flujo (orden obligatorio): certificado → disponibilidad →
      prueba-de-conectividad → envío. Activa un certificado, confirma que el
      rail reporta listo, pasa una prueba de conectividad y luego envía una
      operación. Cada paso es su propio recurso; no debes intentar un envío
      antes de que la disponibilidad pase.
    name: onboarding
  - description: >-
      Flujo (orden obligatorio): operación padre SETTLED →
      devolución/cancelación. Una devolución o cancelación es un sub-recurso de
      una operación padre liquidada; el segmento de ruta
      {operationId}/{endToEndID} impone el padre estructuralmente.
    name: lifecycle
paths:
  /v1/str/reserve-statement-queries/{id}:
    get:
      tags:
        - ReserveQueries
      summary: >-
        Leer el resultado de la consulta de extrato de reservas STR0014 (modo
        mensaje)
      description: >-
        Lee el resultado de una consulta de extrato de cuenta de reservas
        STR0014 enviada previamente por su id de correlación. Devuelve PENDING
        hasta que llega la respuesta STR0014R1, luego los saldos de
        apertura/cierre y el grupo de asientos liquidados que envió BACEN, de
        forma literal. Devuelve 422 cuando la respuesta requiere recuperación en
        modo archivo (BACEN devolvió metadatos de archivo o la ventana excedió
        el tope de 200 asientos del modo mensaje); la lista de asientos nunca se
        trunca de forma silenciosa.
      operationId: getReserveStatementQuery
      parameters:
        - description: >-
            Correlation id returned by POST /v1/str/reserve-statement-queries
            (the outbound STR0014 NUOp).
          in: path
          name: id
          required: true
          schema:
            description: >-
              Correlation id returned by POST /v1/str/reserve-statement-queries
              (the outbound STR0014 NUOp).
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReserveStatementQueryResultResponse'
          description: OK
        default:
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Detail'
          description: Error
      security:
        - BearerAuth: []
components:
  schemas:
    ReserveStatementQueryResultResponse:
      additionalProperties: false
      properties:
        correlationId:
          description: Request-scoped correlation identifier echoing X-Request-ID.
          examples:
            - req-7a3f9c2e
          type: string
        dtHrBC:
          description: >-
            BACEN timestamp of the statement (DtHrBC), verbatim. Empty while
            PENDING.
          examples:
            - '2026-06-15T18:00:00'
          type: string
        dtMovto:
          description: >-
            Movement date the statement applies to (DtMovto), verbatim. Empty
            while PENDING.
          examples:
            - '2026-06-15'
          type: string
        entries:
          description: >-
            Settled-entry group BACEN sent (Grupo_STR0014R1_Lanc), verbatim. Up
            to 200 entries; empty while PENDING.
          items:
            $ref: '#/components/schemas/ReserveStatementEntryResponse'
          type:
            - array
            - 'null'
        id:
          description: Correlation id (the outbound STR0014 NUOp).
          examples:
            - '12345678202606150000014'
          type: string
        ispbIfLdl:
          description: ISPB of the requesting financial institution / clearing house.
          examples:
            - '12345678'
          type: string
        receivedAt:
          description: >-
            RFC3339 UTC freshness timestamp the answer was projected. Empty
            while PENDING.
          examples:
            - '2026-06-15T18:00:01Z'
          format: date-time
          type: string
        sldFinl:
          description: Closing balance BACEN sent (SldFinl), verbatim. Empty while PENDING.
          examples:
            - '1234567.89'
          type: string
        sldInial:
          description: >-
            Opening balance BACEN sent (SldInial), verbatim. Empty while
            PENDING.
          examples:
            - '1000000.00'
          type: string
        status:
          description: >-
            PENDING until the STR0014R1 answer arrives; ANSWERED once a
            message-mode statement has been projected.
          examples:
            - ANSWERED
          type: string
      required:
        - id
        - ispbIfLdl
        - status
        - correlationId
      type: object
    Detail:
      additionalProperties: false
      properties:
        code:
          description: >-
            Stable, machine-readable domain error code scoped to the emitting
            service (format: <SERVICE>-NNNN).
          examples:
            - ERR-0001
          type: string
        detail:
          description: >-
            A human-readable explanation specific to this occurrence of the
            problem.
          examples:
            - Property foo is required but is missing.
          type: string
        errors:
          description: Optional list of individual error details
          items:
            $ref: '#/components/schemas/ErrorDetail'
          type:
            - array
            - 'null'
        instance:
          description: >-
            A URI reference that identifies the specific occurrence of the
            problem.
          examples:
            - https://example.com/error-log/abc123
          format: uri
          type: string
        status:
          description: HTTP status code
          examples:
            - 400
          format: int64
          type: integer
        title:
          description: >-
            A short, human-readable summary of the problem type. This value
            should not change between occurrences of the error.
          examples:
            - Bad Request
          type: string
        type:
          default: about:blank
          description: A URI reference to human-readable documentation for the error.
          examples:
            - https://example.com/errors/example
          format: uri
          type: string
      type: object
    ReserveStatementEntryResponse:
      additionalProperties: false
      properties:
        codMsgOr:
          description: Original message code of the settled entry.
          examples:
            - STR0008
          type: string
        dtHrSit:
          description: Situation timestamp.
          examples:
            - '2026-06-15T09:30:00'
          type: string
        ispbCtrapart:
          description: Counterparty ISPB (optional).
          examples:
            - '87654321'
          type: string
        numCtrlIfLdlOr:
          description: Original IF/LDL control number (optional).
          examples:
            - '20260615000001'
          type: string
        numCtrlStrOr:
          description: Original STR control number.
          examples:
            - STR2026061500001
          type: string
        tpDebCred:
          description: Debit/credit indicator (D = debit, C = credit).
          examples:
            - C
          type: string
        vlrLanc:
          description: Entry amount, verbatim.
          examples:
            - '234567.89'
          type: string
      required:
        - codMsgOr
        - numCtrlStrOr
        - dtHrSit
        - tpDebCred
        - vlrLanc
      type: object
    ErrorDetail:
      additionalProperties: false
      properties:
        location:
          description: >-
            Where the error occurred, e.g. 'body.items[3].tags' or
            'path.thing-id'
          type: string
        message:
          description: Error message text
          type: string
        value:
          description: The value at the given location
      type: object
  securitySchemes:
    BearerAuth:
      bearerFormat: JWT
      description: JWT bearer token issued by the identity provider.
      scheme: bearer
      type: http

````