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

# List the grades de horário the câmara published

> Every grade de horário this rail received from the SILOC câmara, newest reference date first — both the unsolicited change advice (LDL0024) and the answers to schedule queries this institution issued (LDL0023R1), with source saying which leg delivered each row. Narrow with source to read one leg, or with referenceDate to read the hours that apply to one day. Projected verbatim (Catálogo de Serviços do SFN v5.13, Vol II): the câmara's own clock, its own 5-character grid code, and no canonical window resolved from either.



## OpenAPI

````yaml /en/openapi/v3-current/siloc.yaml get /api/v1/siloc/schedule/grids
openapi: 3.1.0
info:
  description: >-
    OpenAPI 3.1 surface for Lerian SILOC, the participant-side rail connecting
    the institution to Núclea's SILOC deferred-net interbank settlement.
  title: Lerian SILOC API
  version: 1.0.0
servers:
  - url: https://siloc.sandbox.lerian.net
security: []
paths:
  /api/v1/siloc/schedule/grids:
    get:
      tags:
        - Schedule
      summary: List the grades de horário the câmara published
      description: >-
        Every grade de horário this rail received from the SILOC câmara, newest
        reference date first — both the unsolicited change advice (LDL0024) and
        the answers to schedule queries this institution issued (LDL0023R1),
        with source saying which leg delivered each row. Narrow with source to
        read one leg, or with referenceDate to read the hours that apply to one
        day. Projected verbatim (Catálogo de Serviços do SFN v5.13, Vol II): the
        câmara's own clock, its own 5-character grid code, and no canonical
        window resolved from either.
      operationId: listScheduleGrids
      parameters:
        - description: Restrict to one delivering message; omit for both legs.
          explode: false
          in: query
          name: source
          schema:
            description: Restrict to one delivering message; omit for both legs.
            enum:
              - LDL0024
              - LDL0023R1
            type: string
        - description: Restrict to the grids that apply to one date (DtRef), YYYY-MM-DD.
          explode: false
          in: query
          name: referenceDate
          schema:
            description: Restrict to the grids that apply to one date (DtRef), YYYY-MM-DD.
            format: date
            type: string
        - description: Opaque pagination cursor.
          explode: false
          in: query
          name: cursor
          schema:
            description: Opaque pagination cursor.
            type: string
        - description: Page size (default 50, max 200).
          explode: false
          in: query
          name: limit
          schema:
            default: 50
            description: Page size (default 50, max 200).
            format: int64
            maximum: 200
            minimum: 1
            type: integer
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GridListResponse'
          description: OK
        '422':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Detail'
          description: Unprocessable Entity
        '500':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Detail'
          description: Internal Server Error
        default:
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Detail'
          description: Error
      security:
        - BearerAuth: []
components:
  schemas:
    GridListResponse:
      additionalProperties: false
      properties:
        hasMore:
          description: Whether a further page exists.
          type: boolean
        items:
          description: >-
            The grids on this page, newest reference date first (never null;
            empty when none match).
          items:
            $ref: '#/components/schemas/GridResponse'
          type: array
        nextCursor:
          description: Opaque cursor for the next page; empty when exhausted.
          type: string
      required:
        - items
        - hasMore
      type: object
    Detail:
      additionalProperties: true
      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
    GridResponse:
      additionalProperties: false
      properties:
        announcedAt:
          description: DtHrLDL, when the câmara announced it, on its own clock, verbatim.
          format: date-time
          type: string
        closesAt:
          description: Data Hora Fechamento, the câmara's clock, verbatim.
          format: date-time
          type: string
        codGrdLDL:
          description: >-
            Código Grade LDL, the câmara's own 5-character grid code. It is NOT
            a canonical window sequence and nothing here resolves it to one.
          type: string
        codProdt:
          description: >-
            The SILOC product. Optional on both messages, so omitted when the
            wire did not send it.
          type: string
        id:
          description: Stored grid id.
          format: uuid
          type: string
        ispbIF:
          description: >-
            This institution's ISPB. Carried by LDL0023R1 alone, so omitted on
            an LDL0024 row rather than fabricated.
          type: string
        ispbLDL:
          description: >-
            The câmara's ISPB. Carried by LDL0024 alone, so omitted on an
            LDL0023R1 row rather than fabricated.
          type: string
        numCtrl:
          description: >-
            The control number of the delivering message — the câmara's own
            (NumCtrlLDL) on LDL0024, this institution's own echoed back
            (NumCtrlIF) on LDL0023R1.
          type: string
        nuop:
          description: >-
            The BCMSG operation number of the frame this row was projected from,
            so a stored grid traces back to the delivered message.
          type: string
        opensAt:
          description: Data Hora Abertura, the câmara's clock, verbatim.
          format: date-time
          type: string
        receivedAt:
          description: When this rail stored the row.
          format: date-time
          type: string
        referenceDate:
          description: >-
            DtRef, the date the grid applies to. An eventual grid applies to
            this date alone.
          format: date
          type: string
        scheduleType:
          description: >-
            Tipo Horário, verbatim. Documented values are P (padrão) and E
            (eventual); the official type enumerates nothing, so a third value
            is shown rather than refused.
          type: string
        source:
          description: >-
            The message that delivered this grid: LDL0024 is the câmara's
            unsolicited advice, LDL0023R1 the answer to a query this institution
            issued.
          enum:
            - LDL0024
            - LDL0023R1
          type: string
      required:
        - id
        - source
        - numCtrl
        - codGrdLDL
        - opensAt
        - closesAt
        - scheduleType
        - referenceDate
        - announcedAt
        - nuop
        - receivedAt
      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

````