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

# Totals for the day (volumes, amounts, statuses, window)

> Daily summary for the operations dashboard: the operating window of the date, the aggregates of outgoing TEDs (count, amount, distribution by status, rejections by code) and of incoming TEDs (count, amount, status, returns by code), and, for the current day, the number of items in each operations queue.

Internal transfers are not part of `outbound`. Send `date` (`YYYY-MM-DD`) for a past day. Without `date`, the service uses today in the institution's time zone. For a past date, `queue` is not returned.



## OpenAPI

````yaml /es/openapi/v3-current/ted-lerian.yaml get /v1/operations/summary
openapi: 3.1.0
info:
  description: >-
    API of **TED Lerian**, the interface over Lerian SPB. Your institution uses
    it to send TEDs, make internal transfers, track incoming TEDs, and operate
    returns, queues, and policy on its Midaz ledger. The [API
    overview](/es/reference/interfaces/ted-lerian/ted-lerian-api-overview) gives
    the concepts, the roles, and the conventions.
  title: TED Lerian API
  version: v1.0.0
servers:
  - url: https://api.example.com
    description: >-
      Replace the example host with the URL provided during environment
      onboarding.
security:
  - BearerAuth: []
tags:
  - description: >-
      Outgoing TEDs and internal transfers: fee quote, creation, query,
      timeline, and cancellation. Every integration starts here.
    name: Transfers
  - description: >-
      Incoming TEDs from other institutions: query, timeline, and operator
      actions (full return and manual review resolution).
    name: Incoming Transfers
  - description: >-
      STR participant list, to resolve COMPE code ↔ ISPB and validate the
      destination bank before you create a transfer.
    name: Participants
  - description: >-
      Back office: operations queue, inconsistency findings between the ledger
      and the STR, reviews of rail facts, held returns, and manual unblock with
      evidence.
    name: Reconciliation
  - description: >-
      Operations dashboard: daily aggregates, regulatory deadlines (30/60/60
      min), and the closing balance that the STR reported.
    name: Operations
  - description: >-
      Institution configuration (editor): operating window and cut-off, usage
      limits, holiday calendar, and ISPB → organization bindings.
    name: Policy
paths:
  /v1/operations/summary:
    get:
      tags:
        - Operations
      summary: Totals for the day (volumes, amounts, statuses, window)
      description: >-
        Daily summary for the operations dashboard: the operating window of the
        date, the aggregates of outgoing TEDs (count, amount, distribution by
        status, rejections by code) and of incoming TEDs (count, amount, status,
        returns by code), and, for the current day, the number of items in each
        operations queue.


        Internal transfers are not part of `outbound`. Send `date`
        (`YYYY-MM-DD`) for a past day. Without `date`, the service uses today in
        the institution's time zone. For a past date, `queue` is not returned.
      operationId: getOperationsSummary
      parameters:
        - description: >-
            Reference date (YYYY-MM-DD); default = today in the institution time
            zone.
          explode: false
          in: query
          name: date
          schema:
            description: >-
              Reference date (YYYY-MM-DD); default = today in the institution
              time zone.
            type: string
        - $ref: '#/components/parameters/XRequestId'
      responses:
        '200':
          content:
            application/json:
              example:
                date: '2026-10-22'
                generatedAt: '2026-10-22T18:00:00Z'
                inbound:
                  amount: '987120.10'
                  byStatus:
                    CREDITED: 330
                    MANUAL_REVIEW: 4
                    RECORDED: 6
                    RETURNED: 2
                  count: 342
                  returnsByCode:
                    '2': 1
                    '5': 1
                outbound:
                  amount: '412350.75'
                  byStatus:
                    AWAITING_RECONCILIATION: 1
                    REJECTED: 2
                    SETTLED: 120
                    SUBMITTED: 5
                  count: 128
                  rejectionsByCode:
                    STR0015: 1
                    TED-0031: 1
                queue:
                  awaitingReconciliation: 1
                  exhausted: 0
                  manualReview: 4
                  pendingStr: 0
                window:
                  clientCutoffTime: '17:00'
                  date: '2026-10-22'
                  effectiveClosesAt: '2026-10-22T20:00:00Z'
                  effectiveOpensAt: '2026-10-22T09:30:00Z'
                  isBusinessDay: true
                  isOpen: true
                  officialClosesAt: '2026-10-22T20:30:00Z'
                  source: OFFICIAL_SCHEDULE_WITH_CUTOFF
              schema:
                $ref: '#/components/schemas/OperationsSummary'
          description: Operations summary of the requested date.
          headers:
            X-Request-Id:
              $ref: '#/components/headers/XRequestId'
        '400':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Detail'
          description: Invalid reference date (`TED-0001`).
          headers:
            X-Request-Id:
              $ref: '#/components/headers/XRequestId'
        '401':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Detail'
          description: 'Not authenticated: token missing, invalid, or expired (`TED-0070`).'
          headers:
            X-Request-Id:
              $ref: '#/components/headers/XRequestId'
        '403':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Detail'
          description: >-
            No permission: the token's role does not authorize this action, or
            the product license is not valid for the organization (`TED-0071`).
          headers:
            X-Request-Id:
              $ref: '#/components/headers/XRequestId'
        '422':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Detail'
          description: >-
            Parameter outside the declared format (for example, a `date` that is
            not YYYY-MM-DD): framework validation, with no TED code.
          headers:
            X-Request-Id:
              $ref: '#/components/headers/XRequestId'
        '500':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Detail'
          description: >-
            Unexpected failure (`TED-9000`). If it continues, contact support
            and give the `X-Request-Id` of the response.
          headers:
            X-Request-Id:
              $ref: '#/components/headers/XRequestId'
        '503':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Detail'
          description: >-
            Institution configuration missing (`TED-0080`), or the operating
            window cannot be determined (`TED-0022`).
          headers:
            X-Request-Id:
              $ref: '#/components/headers/XRequestId'
components:
  parameters:
    XRequestId:
      description: >-
        Correlation identifier of this request (UUID). Optional: when you omit
        it, or when the value is not a well-formed UUID, the platform creates a
        UUID and returns it in the X-Request-Id header of the response. The
        resolved identifier goes to the logs, spans, and audit events of this
        request. Keep it to open a support ticket.
      in: header
      name: X-Request-Id
      schema:
        format: uuid
        type: string
  schemas:
    OperationsSummary:
      additionalProperties: false
      description: >-
        Daily aggregates for the operations dashboard: operating window,
        outgoing TEDs, incoming TEDs, and open queues.
      properties:
        date:
          description: Reference date (YYYY-MM-DD).
          format: date
          type: string
        generatedAt:
          description: Time (UTC) when the summary was generated.
          format: date-time
          type: string
        inbound:
          $ref: '#/components/schemas/OperationsSummaryInbound'
          description: Incoming TEDs.
        outbound:
          $ref: '#/components/schemas/OperationsSummaryOutbound'
          description: Outgoing TEDs (internal transfers excluded).
        queue:
          $ref: '#/components/schemas/OperationsQueueSummary'
          description: Operations queues now. Absent for a past date.
        window:
          $ref: '#/components/schemas/OperatingWindow'
      required:
        - date
        - window
        - outbound
        - inbound
      type: object
    Detail:
      additionalProperties: true
      description: >-
        Standard error body (RFC 9457, `application/problem+json`) for every
        `/v1` operation. Use `code` (TED-NNNN) to handle the error in code,
        `detail` for the readable message, and `errors` for the invalid fields
        of a 422. The `X-Request-Id` of the response identifies the occurrence
        for support.
      properties:
        code:
          description: >-
            Stable, machine-readable domain error code scoped to the emitting
            service (format: <SERVICE>-NNNN).
          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.
      type: object
    OperationsSummaryInbound:
      additionalProperties: false
      description: >-
        Totals of incoming TEDs for the day: count, total amount, breakdown by
        status, and returns by code.
      properties:
        amount:
          description: Sum of the amounts received in the day (BRL).
          examples:
            - '1500.00'
          pattern: ^(0|[1-9][0-9]{0,11})\.[0-9]{2}$
          type: string
        byStatus:
          additionalProperties:
            format: int64
            type: integer
          description: Count by current status.
          type: object
        count:
          description: Number of incoming TEDs in the day.
          format: int64
          type: integer
        returnsByCode:
          additionalProperties:
            format: int64
            type: integer
          description: Number of returns by official code (CodDevTransf).
          type: object
      type: object
    OperationsSummaryOutbound:
      additionalProperties: false
      description: >-
        Aggregates of the outgoing TEDs of the day: count, total amount,
        distribution by status, and rejections by code.
      properties:
        amount:
          description: Sum of the amounts sent in the day (BRL).
          examples:
            - '1500.00'
          pattern: ^(0|[1-9][0-9]{0,11})\.[0-9]{2}$
          type: string
        byStatus:
          additionalProperties:
            format: int64
            type: integer
          description: Count by current status.
          type: object
        count:
          description: Number of outgoing TEDs in the day.
          format: int64
          type: integer
        rejectionsByCode:
          additionalProperties:
            format: int64
            type: integer
          description: Number of rejections by code (rejection.code).
          type: object
      type: object
    OperationsQueueSummary:
      additionalProperties: false
      description: Number of items in each operations queue at this instant.
      properties:
        awaitingReconciliation:
          description: Outgoing TEDs in AWAITING_RECONCILIATION.
          format: int64
          type: integer
        exhausted:
          description: Outgoing TEDs in EXHAUSTED.
          format: int64
          type: integer
        manualReview:
          description: Incoming TEDs in MANUAL_REVIEW.
          format: int64
          type: integer
        pendingStr:
          description: Sent TEDs in PENDING_STR.
          format: int64
          type: integer
      type: object
    OperatingWindow:
      additionalProperties: false
      description: >-
        Effective operating window of a day: the official STR schedule, narrowed
        by the institution cut-off and the holiday calendar. Outside it, send
        requests are refused with `TED-0020`/`TED-0021`.
      properties:
        clientCutoffTime:
          description: >-
            Cut-off configured by the institution (HH:MM, local time). Missing
            when there is no cut-off.
          type: string
        date:
          description: Calendar day that this window describes (YYYY-MM-DD).
          format: date
          type: string
        effectiveClosesAt:
          description: >-
            Effective close (UTC): the earlier of the official STR close and the
            institution cut-off.
          format: date-time
          type: string
        effectiveOpensAt:
          description: Effective opening of the window in the day (UTC).
          format: date-time
          type: string
        isBusinessDay:
          description: false on a weekend or national holiday.
          type: boolean
        isOpen:
          description: If the window is open at the time of the query.
          type: boolean
        officialClosesAt:
          description: >-
            Official close of the STR (UTC). Missing on a day with no published
            schedule (weekend, holiday).
          format: date-time
          type: string
        source:
          description: >-
            What decided the response: OFFICIAL_SCHEDULE (official schedule),
            OFFICIAL_SCHEDULE_WITH_CUTOFF (schedule narrowed by the cut-off),
            HOLIDAY, or WEEKEND.
          enum:
            - OFFICIAL_SCHEDULE
            - OFFICIAL_SCHEDULE_WITH_CUTOFF
            - HOLIDAY
            - WEEKEND
          type: string
      required:
        - date
        - isBusinessDay
        - isOpen
        - effectiveOpensAt
        - effectiveClosesAt
        - source
      type: object
    ErrorDetail:
      additionalProperties: false
      description: >-
        An invalid field inside a validation error: where it is (`location`),
        what is wrong (`message`), and the value received.
      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
      description: >-
        Error reported by an upstream system (ledger or rail), when the service
        chooses to expose it. Absent in most errors.
      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
  headers:
    XRequestId:
      description: >-
        Echo of the request X-Request-Id: the value that the client sent, or the
        UUID that the platform generated when the client sent none. Present in
        every response, success or error.
      schema:
        format: uuid
        type: string
  securitySchemes:
    BearerAuth:
      bearerFormat: JWT
      description: >-
        JWT token that the Lerian Access Manager issues for your institution.
        Send it in `Authorization: Bearer <token>` on every call (except the
        public health probes). The tenant never comes from the body, the query,
        or the path. Each operation requires a role with the matching permission
        (see the API overview). Without it, 403 `TED-0071`. Missing, invalid, or
        expired token: 401 `TED-0070`.
      scheme: bearer
      type: http

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.