> ## 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 saldo de reservas STR0013 > Lee el resultado de una consulta de saldo de cuenta de reservas STR0013 enviada previamente por su id de correlación. Devuelve PENDING hasta que llega la respuesta STR0013R1, luego el saldo de cuenta de reservas que envió BACEN (SldRB_CL) más una marca de tiempo de frescura. ## OpenAPI ````yaml es/openapi/v3-current/spb.yaml get /v1/str/reserve-balance-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-balance-queries/{id}: get: tags: - ReserveQueries summary: Leer el resultado de la consulta de saldo de reservas STR0013 description: >- Lee el resultado de una consulta de saldo de cuenta de reservas STR0013 enviada previamente por su id de correlación. Devuelve PENDING hasta que llega la respuesta STR0013R1, luego el saldo de cuenta de reservas que envió BACEN (SldRB_CL) más una marca de tiempo de frescura. operationId: getReserveBalanceQuery parameters: - description: >- Correlation id returned by POST /v1/str/reserve-balance-queries (the outbound STR0013 NUOp). in: path name: id required: true schema: description: >- Correlation id returned by POST /v1/str/reserve-balance-queries (the outbound STR0013 NUOp). type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/ReserveBalanceQueryResultResponse' description: OK default: content: application/problem+json: schema: $ref: '#/components/schemas/Detail' description: Error security: - BearerAuth: [] components: schemas: ReserveBalanceQueryResultResponse: additionalProperties: false properties: correlationId: description: Request-scoped correlation identifier echoing X-Request-ID. examples: - req-7a3f9c2e type: string dtHrBC: description: >- BACEN timestamp of the balance (DtHrBC), verbatim. Empty while PENDING. examples: - '2026-06-15T10:00:00' type: string dtMovto: description: >- Movement date the balance applies to (DtMovto), verbatim. Empty while PENDING. examples: - '2026-06-15' type: string id: description: Correlation id (the outbound STR0013 NUOp). examples: - '12345678202606150000013' 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-15T10:00:01Z' format: date-time type: string sldRbCl: description: >- Reserve-account balance BACEN sent in the STR0013R1 (SldRB_CL — conta Reservas Bancárias / Conta de Liquidação), verbatim. Empty while PENDING. examples: - '987654321.55' type: string status: description: >- PENDING until the STR0013R1 answer arrives; ANSWERED once the balance 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: -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 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 ````