> ## 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 one PAG0108 instruction and its answer

> The stored PAG0108 request projected verbatim, its dispatch state, and — once the câmara has answered — the Número Controle PAG and the Situação Lançamento PAG it assigned, also verbatim. status is SUBMITTED (recorded; still queued, retried on a backoff), DISPATCHED (on the queue, awaiting the answer), ANSWERED, REFUSED (the câmara returned the PAG0108E twin; lastError carries its CodErro values) or FAILED (this rail could not deliver it). sitLancPAG is projected VERBATIM and never decoded: its values are published separately in the Dicionário de Domínios, with activation and deactivation dates per value, so what a situação means about the money is the ledger consumer's call.



## OpenAPI

````yaml /es/openapi/v3-current/siloc.yaml get /api/v1/siloc/outbound/client-account-transfers/{id}
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/outbound/client-account-transfers/{id}:
    get:
      tags:
        - Transfers
      summary: Read one PAG0108 instruction and its answer
      description: >-
        The stored PAG0108 request projected verbatim, its dispatch state, and —
        once the câmara has answered — the Número Controle PAG and the Situação
        Lançamento PAG it assigned, also verbatim. status is SUBMITTED
        (recorded; still queued, retried on a backoff), DISPATCHED (on the
        queue, awaiting the answer), ANSWERED, REFUSED (the câmara returned the
        PAG0108E twin; lastError carries its CodErro values) or FAILED (this
        rail could not deliver it). sitLancPAG is projected VERBATIM and never
        decoded: its values are published separately in the Dicionário de
        Domínios, with activation and deactivation dates per value, so what a
        situação means about the money is the ledger consumer's call.
      operationId: getPAG0108
      parameters:
        - description: Outbound message id.
          in: path
          name: id
          required: true
          schema:
            description: Outbound message id.
            format: uuid
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PagTransferBodyPAG0108Payload'
          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:
    PagTransferBodyPAG0108Payload:
      additionalProperties: false
      properties:
        answer:
          $ref: '#/components/schemas/PAGTransferAnswerResponse'
          description: What the câmara answered; omitted until it has answered.
        answerAbsent:
          description: >-
            True only on an ANSWERED message whose answer body this rail does
            not hold. The câmara did answer; what it wrote is not here, and the
            missing answer block is that absence, never an empty answer. Omitted
            otherwise.
          type: boolean
        answeredAt:
          description: When the câmara's answer was applied; omitted until it is.
          format: date-time
          type: string
        attempts:
          description: Queue-put attempts made so far.
          format: int64
          type: integer
        codMsg:
          description: The SFN instruction code this row carries, e.g. PAG0107.
          type: string
        dispatchedAt:
          description: When the frame reached the send queue; omitted until it has.
          format: date-time
          type: string
        id:
          description: Outbound message id.
          format: uuid
          type: string
        lastError:
          description: >-
            Why the last queue put failed, or — on REFUSED — the CodErro values
            the câmara marked, verbatim. Omitted when neither applies.
          type: string
        numCtrlIF:
          description: >-
            The control number this institution issued (NumCtrlIF). The câmara
            echoes it on the answer, which is what correlates the two.
          type: string
        nuop:
          description: The BCMSG operation number of the frame.
          type: string
        request:
          $ref: '#/components/schemas/PAG0108Payload'
          description: The request exactly as it was submitted, projected verbatim.
        status:
          description: >-
            Lifecycle state. REFUSED means the câmara received the instruction
            and returned its E twin; FAILED means this rail could not deliver
            it. Both are terminal and they are different facts.
          enum:
            - SUBMITTED
            - DISPATCHED
            - ANSWERED
            - REFUSED
            - FAILED
          type: string
        submittedAt:
          description: When the instruction was recorded.
          format: date-time
          type: string
      required:
        - request
        - id
        - codMsg
        - numCtrlIF
        - nuop
        - status
        - attempts
        - submittedAt
      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
    PAGTransferAnswerResponse:
      additionalProperties: false
      properties:
        codMsg:
          description: The answer's own code, e.g. PAG0107R1.
          type: string
        movementDate:
          description: Data Movimento.
          format: date
          type: string
        numCtrlPAG:
          description: >-
            Número Controle PAG: the CÂMARA's own control number for the
            movement. A later devolução (PAG0111) names it as NumCtrlPAGOr, so
            it is the identifier needed to reverse this transfer.
          type: string
        sitLancPAG:
          description: >-
            Situação Lançamento PAG, exactly as the câmara wrote it. Its values
            are published in BACEN's separate Dicionário de Domínios (AGE, CAN,
            COM, ENF, PEC, PED, REJ), each with its own activation and
            deactivation dates, so this rail neither decodes it nor asserts a
            settlement outcome from it — read it against the dictionary version
            you hold.
          type: string
        situationAt:
          description: 'Data Hora Situação: the câmara''s clock, verbatim.'
          format: date-time
          type: string
      required:
        - codMsg
        - numCtrlPAG
        - sitLancPAG
        - situationAt
        - movementDate
      type: object
    PAG0108Payload:
      additionalProperties: false
      properties:
        AgCredtd:
          description: Agência Creditada (Agencia, [0..1]).
          type: string
        AgDebtd:
          description: Agência Debitada (Agencia, [0..1]).
          type: string
        CNPJ_CPFCliCredtd:
          description: CNPJ ou CPF Cliente Creditado (CNPJ_CPF, [1..1]).
          type: string
        CNPJ_CPFCliDebtd:
          description: CNPJ ou CPF Cliente Debitado (CNPJ_CPF, [1..1]).
          type: string
        CodDocFis:
          description: >-
            Código Documento Fiscal (CodDocFis, [0..1]). Required when the
            Grupo_PAG0108_Split group is supplied; omit the whole group
            otherwise.
          type: string
        CodIdentdTransf:
          description: Código Identificador Transferência (CodIdentdTransf, [0..1]).
          type: string
        CtCredtd:
          description: >-
            Conta Creditada (CtBancaria, [0..1]). Exactly one of CtCredtd or
            CtPgtoCredtd is required.
          type: string
        CtDebtd:
          description: >-
            Conta Debitada (CtBancaria, [0..1]). Exactly one of CtDebtd or
            CtPgtoDebtd is required.
          type: string
        CtPgtoCredtd:
          description: >-
            Conta Pagamento Creditada (CtPgto, [0..1]). Exactly one of CtCredtd
            or CtPgtoCredtd is required.
          type: string
        CtPgtoDebtd:
          description: >-
            Conta Pagamento Debitada (CtPgto, [0..1]). Exactly one of CtDebtd or
            CtPgtoDebtd is required.
          type: string
        DtAgendt:
          description: Data Agendamento (xs:date, [0..1]).
          type: string
        DtMovto:
          description: Data Movimento (xs:date, [1..1]).
          type: string
        FinlddCli:
          description: Finalidade Cliente (FinlddCli, [1..1]).
          type: string
        Hist:
          description: Histórico (Historico, [0..1]).
          type: string
        ISPBIFCredtd:
          description: ISPB IF Creditada (ISPB, [1..1]).
          type: string
        NivelPrefPAG:
          description: Nível Preferência PAG (PrefPAG, [0..1]).
          type: string
        NomCliCredtd:
          description: Nome Cliente Creditado (Nome, [1..1]).
          type: string
        NomCliDebtd:
          description: Nome Cliente Debitado (Nome, [1..1]).
          type: string
        TpCtCredtd:
          description: Tipo Conta Creditada (TpCt, [1..1]).
          type: string
        TpCtDebtd:
          description: Tipo Conta Debitada (TpCt, [1..1]).
          type: string
        TpPessoaCredtd:
          description: Tipo Pessoa Creditada (TpPessoa, [1..1]).
          type: string
        TpPessoaDebtd:
          description: Tipo Pessoa Debitada (TpPessoa, [1..1]).
          type: string
        VlrCBS:
          description: >-
            Valor CBS (VlrNNegtv, [0..1]). Required when the Grupo_PAG0108_Split
            group is supplied; omit the whole group otherwise.
          type: string
        VlrIBS:
          description: >-
            Valor IBS (VlrNNegtv, [0..1]). Required when the Grupo_PAG0108_Split
            group is supplied; omit the whole group otherwise.
          type: string
        VlrLanc:
          description: Valor Lançamento (Valor, [1..1]).
          type: string
      required:
        - TpCtDebtd
        - TpPessoaDebtd
        - CNPJ_CPFCliDebtd
        - NomCliDebtd
        - ISPBIFCredtd
        - TpCtCredtd
        - TpPessoaCredtd
        - CNPJ_CPFCliCredtd
        - NomCliCredtd
        - VlrLanc
        - FinlddCli
        - DtMovto
      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

````