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

# Read SME0003 CCME statement (extrato) query result

> Reads the result of a previously submitted SME0003 conta correspondente a moeda eletrônica (CCME) statement query by its correlation id (the outbound SME0003 NUOp). Returns PENDING until the SME0003R1 answer arrives, then the opening and closing balances BACEN sent, every lançamento in wire order, BACEN's own timestamp and the business date it answered with. A statement with zero entries is still ANSWERED — a CCME with no movement on the day is an answer, not a missing one. Every monetary value crosses as text, verbatim: Lerian SPB never parses or sums a CCME balance and never reconciles the entry sum against the closing balance.



## OpenAPI

````yaml /en/openapi/v3-current/spb.yaml get /v1/str/sme-statement-queries/{nuOp}
openapi: 3.1.0
info:
  contact:
    email: contact@lerian.studio
    name: Lerian Studio
    url: https://lerian.studio
  description: >-
    OpenAPI 3.1 surface for Lerian SPB, the direct integration between the
    institution and the Brazilian Payment System (SPB) over the National
    Financial System Network (RSFN). It covers the Reserve Transfer System
    (STR): message registry and capability catalog, operation lifecycle (bank
    transfers, IBS repasses, liquidity transfers, returns and cancellations),
    reserve-account and schedule queries, alçada governance, SME and LDL
    operations, inbound quarantine triage, reconciliation, and event delivery.
  license:
    name: Lerian Studio General License
  title: Lerian SPB API
  version: 1.0.0
servers:
  - url: https://spb.sandbox.lerian.net
security: []
tags:
  - description: Immutable audit-record trails for STR operations and lifecycle events.
    name: Audit
  - description: >-
      STR capability catalog describing supported message types and their
      constraints.
    name: Capabilities
  - description: >-
      ICP-Brasil certificate inventory with hot-reloadable rotation and
      activation.
    name: Certificates
  - description: >-
      Maker-checker approval queue for emissions parked above their alçada band:
      list pending, sign (approve), and deny.
    name: EmissionApprovals
  - description: Webhook event-delivery records with retry control for failed dispatches.
    name: EventDeliveries
  - description: Operation event catalog enumerating the emitted domain event types.
    name: Events
  - description: >-
      Inbound GEN-family notice log (GEN0001 connectivity echo, GEN0004
      transmission error, GEN0005 administrative notice).
    name: GenNotices
  - description: >-
      SPB alçada governance config: value-band table + per-message-type
      signature requirements, hot-reloaded at runtime.
    name: Governance
  - description: >-
      Read raw STR message status: list messages and read a single message by
      NUOp.
    name: Messages
  - description: Aggregated operational summaries and metrics across STR operations.
    name: OperationalIntelligence
  - description: >-
      STR operation lifecycle for bank transfers and IBS repasses, including
      returns and cancellations.
    name: Operations
  - description: >-
      Service readiness state covering startup self-probes and dependency
      health.
    name: Readiness
  - description: Reconciliation cases and the actions that resolve operation discrepancies.
    name: Reconciliation
  - description: >-
      STR Relatórios suite: synchronous, date-ranged aggregate reports
      (movimento financeiro, transações rejeitadas, volumetria) over Lerian
      SPB's own transmission record.
    name: Reports
  - description: >-
      STR0013 reserve-account balance and STR0014 statement (extrato,
      message-mode) queries and their async results.
    name: ReserveQueries
  - description: >-
      GEN0019 participant responsável roster: full-replacement updates announced
      to BACEN.
    name: Responsibles
  - description: STR operating-window schedule governing when operations may be sent.
    name: Schedule
  - description: >-
      STR0001 single-party schedule queries (consulta de horários do STR) and
      their async STR0001R1 grid results.
    name: ScheduleQueries
  - description: >-
      Reads over an IEME's conta correspondente a moeda eletrônica (CCME):
      SME0003 statement (extrato) queries and their async SME0003R1 results,
      plus the log of SME0001R2/SME0002R2/SME0004R2 movement advices the STR
      delivered about movements this rail did not command.
    name: SMEQueries
  - description: Runtime SPB configuration settings for the STR integration.
    name: Settings
  - description: Webhook endpoint registration and management for event delivery.
    name: Webhooks
  - description: >-
      Flow (mandatory order): certificate → readiness → connectivity-test →
      submit. Activate a certificate, confirm the rail reports ready, pass a
      connectivity test, then submit an operation. Each step is its own
      resource; a submit must not be attempted before readiness passes.
    name: onboarding
  - description: >-
      Flow (mandatory order): parent operation SETTLED → return/cancel. A return
      or cancellation is a sub-resource of a settled parent operation; the
      {operationId}/{endToEndID} path segment enforces the parent structurally.
    name: lifecycle
paths:
  /v1/str/sme-statement-queries/{nuOp}:
    get:
      tags:
        - SMEQueries
      summary: Read SME0003 CCME statement (extrato) query result
      description: >-
        Reads the result of a previously submitted SME0003 conta correspondente
        a moeda eletrônica (CCME) statement query by its correlation id (the
        outbound SME0003 NUOp). Returns PENDING until the SME0003R1 answer
        arrives, then the opening and closing balances BACEN sent, every
        lançamento in wire order, BACEN's own timestamp and the business date it
        answered with. A statement with zero entries is still ANSWERED — a CCME
        with no movement on the day is an answer, not a missing one. Every
        monetary value crosses as text, verbatim: Lerian SPB never parses or
        sums a CCME balance and never reconciles the entry sum against the
        closing balance.
      operationId: getSMEStatementQuery
      parameters:
        - description: >-
            Correlation id returned by POST /v1/str/sme-statement-queries (the
            outbound SME0003 NUOp; 23 characters: ISPB[8]+DATE[8]+SEQ[7]).
          in: path
          name: nuOp
          required: true
          schema:
            description: >-
              Correlation id returned by POST /v1/str/sme-statement-queries (the
              outbound SME0003 NUOp; 23 characters: ISPB[8]+DATE[8]+SEQ[7]).
            maxLength: 23
            minLength: 23
            pattern: ^[0-9A-Z]{8}[0-9]{15}$
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SMEStatementQueryResultResponse'
          description: OK
        '401':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Detail'
          description: Unauthorized
        '403':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Detail'
          description: Forbidden
        '404':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Detail'
          description: Not Found
        '422':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Detail'
          description: Unprocessable Entity
        '429':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Detail'
          description: Too Many Requests
        '500':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Detail'
          description: Internal Server Error
        '503':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Detail'
          description: Service Unavailable
        default:
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Detail'
          description: Error
      security:
        - BearerAuth: []
components:
  schemas:
    SMEStatementQueryResultResponse:
      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: >-
            Business date BACEN ANSWERED with (DtMovto), verbatim — a different
            fact from movementDate, the date the consulta asked for; RSTR0014
            lets the two legitimately diverge. Empty while PENDING.
          examples:
            - '2026-06-15'
          type: string
        entries:
          description: >-
            Lançamento group BACEN sent (Grupo_SME0003R1_Lanc), verbatim and in
            wire order. Always an array: empty while PENDING, and legitimately
            empty once ANSWERED when the CCME had no movement on the day.
          items:
            $ref: '#/components/schemas/SMEStatementEntryItem'
          type:
            - array
            - 'null'
        id:
          description: Correlation id (the outbound SME0003 NUOp).
          examples:
            - '12345678202606150000014'
          type: string
        ispbIEME:
          description: ISPB of the IEME whose CCME statement was requested.
          examples:
            - '12345678'
          pattern: ^[0-9A-Z]{8}$
          type: string
        movementDate:
          description: >-
            BACEN business date (DtMovto) the consulta ASKED for, derived
            server-side at submit time.
          examples:
            - '2026-06-15'
          type: string
        receivedAt:
          description: >-
            RFC3339 UTC timestamp the SME0003R1 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 as text — never
            parsed or summed. It is NEVER reconciled against the entry sum:
            checking that would be computing a position. Empty while PENDING.
          examples:
            - '1234567.89'
          type: string
        sldInial:
          description: >-
            Opening balance BACEN sent (SldInial), verbatim as text — never
            parsed or summed. Empty while PENDING.
          examples:
            - '1000000.00'
          type: string
        status:
          description: >-
            Projection state: PENDING until the SME0003R1 answer arrives,
            ANSWERED once it has been projected. A statement with zero entries
            is still ANSWERED — a CCME with no movement on the day is an answer,
            not a missing one.
          examples:
            - ANSWERED
          type: string
      required:
        - id
        - ispbIEME
        - status
        - movementDate
        - entries
        - correlationId
      type: object
    Detail:
      additionalProperties: false
      properties:
        code:
          description: >-
            Stable, machine-readable domain error code scoped to the emitting
            service (format: <SERVICE>-NNNN).
          examples:
            - SPB-0001
          type: string
        correlationId:
          description: Request-scoped correlation identifier echoing X-Request-ID.
          examples:
            - req-7a3f9c2e
          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
        upstream:
          $ref: '#/components/schemas/Upstream'
          description: >-
            RFC 9457 extension member: the error a proxied third-party provider
            reported. Absent unless the emitting service explicitly surfaced
            one.
      required:
        - correlationId
      type: object
    SMEStatementEntryItem:
      additionalProperties: false
      properties:
        codMsgOr:
          description: Original message code of the entry, verbatim (optional on the wire).
          examples:
            - SME0001
          type: string
        dtHrSit:
          description: Situation timestamp BACEN sent, verbatim.
          examples:
            - '2026-06-15T09:30:00'
          type: string
        ispbCtrapart:
          description: Counterparty ISPB, verbatim (optional on the wire).
          examples:
            - '87654321'
          pattern: ^[0-9A-Z]{8}$
          type: string
        numCtrlIEMEOr:
          description: Original IEME control number, verbatim (optional on the wire).
          examples:
            - '20260615000000000001'
          type: string
        numCtrlSMEOr:
          description: >-
            Original SME control number — the second xs:choice branch, carried
            by a remuneration entry (RSME0003).
          examples:
            - SME2026061500002
          type: string
        numCtrlSTROr:
          description: Original STR control number — the first xs:choice branch.
          examples:
            - STR2026061500001
          type: string
        tpDebCred:
          description: >-
            Debit/credit indicator BACEN sent (D = debit, C = credit). The
            direction of the entry — the amount never carries a sign.
          examples:
            - C
          type: string
        vlrLanc:
          description: Entry amount BACEN sent, verbatim as text — never parsed or summed.
          examples:
            - '234567.89'
          type: string
      required:
        - 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
    Upstream:
      additionalProperties: false
      properties:
        code:
          description: The upstream provider's own error code, verbatim.
          examples:
            - E4001
          type: string
        message:
          description: >-
            The upstream provider's own error message, verbatim (bounded, never
            its raw response body).
          examples:
            - account not found at provider
          type: string
      type: object
  securitySchemes:
    BearerAuth:
      bearerFormat: JWT
      description: JWT bearer token issued by the identity provider.
      scheme: bearer
      type: http

````