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

# Obter log de auditoria por ID

> Use este endpoint para recuperar os detalhes de uma entrada específica do log de auditoria pelo seu identificador. Os logs de auditoria contêm registros imutáveis de todas as operações do sistema para fins de conformidade e depuração.



## OpenAPI

````yaml pt/openapi/v3-current/matcher.yaml get /v1/governance/audit-logs/{id}
openapi: 3.1.0
info:
  title: Matcher APIs
  description: >-
    Referência completa de API para o motor de conciliação Matcher, que fornece
    conciliação automática de transações entre o Midaz Ledger e sistemas
    externos.
  version: 4.1.0
  license:
    name: Lerian Studio General License
servers:
  - url: https://matcher.sandbox.lerian.net
security: []
paths:
  /v1/governance/audit-logs/{id}:
    get:
      tags:
        - Governance
      summary: Obter log de auditoria por ID
      description: >-
        Use este endpoint para recuperar os detalhes de uma entrada específica
        do log de auditoria pelo seu identificador. Os logs de auditoria contêm
        registros imutáveis de todas as operações do sistema para fins de
        conformidade e depuração.
      operationId: getAuditLog
      parameters:
        - description: A unique identifier for tracing the request across services.
          in: header
          name: X-Request-Id
          schema:
            type: string
        - description: Audit Log ID
          in: path
          name: id
          required: true
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: >-
            Indica que a requisição foi bem-sucedida e a resposta contém os
            dados esperados.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AuditLogResponse'
        '400':
          description: A requisição contém parâmetros ou payload inválidos.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: A requisição não contém credenciais de autenticação válidas.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Você não tem permissão para acessar este recurso.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                ErrorM0103:
                  $ref: '#/components/examples/ErrorM0103'
        '404':
          description: O recurso solicitado não foi encontrado.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Ocorreu um erro inesperado no servidor.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - BearerAuth: []
components:
  schemas:
    AuditLogResponse:
      description: Entrada imutável do log de auditoria para rastreamento de governança
      properties:
        action:
          description: Ação que foi executada
          example: CREATE
          type: string
        actorId:
          description: ID do ator que executou a ação
          example: user@example.com
          type: string
        changes:
          description: Alterações feitas na entidade
          items:
            type: integer
          type: array
        createdAt:
          description: Timestamp de criação no formato RFC3339
          example: '2025-01-15T10:30:00.000Z'
          type: string
        entityId:
          description: ID da entidade que foi modificada
          example: 019c96a0-10a0-72d2-9fb0-2b7de8093182
          type: string
        entityType:
          description: Tipo de entidade que foi modificada
          example: reconciliation_context
          type: string
        id:
          description: Identificador único da entrada do log de auditoria
          example: 019c96a0-0b61-71a2-8595-dde786b5bcc6
          type: string
        tenantId:
          description: ID do tenant que é proprietário desta entrada do log de auditoria
          example: 019c96a0-0a98-7287-9a31-786e0809c769
          type: string
        truncated:
          description: >-
            Verdadeiro quando o diff de auditoria original excedeu o limite de
            payload e foi substituído por um marcador de truncamento
          example: false
          type: boolean
        originalSize:
          description: >-
            Tamanho em bytes do diff original antes do truncamento; zero quando
            não truncado
          example: 0
          format: int64
          type: integer
      type: object
    ErrorResponse:
      description: Resposta de erro padrão retornada por todos os endpoints da API
      type: object
      required:
        - code
        - title
        - message
      properties:
        code:
          type: string
          description: Código de erro de aplicação estável.
          example: MTCH-0001
        title:
          type: string
          description: Título de erro legível por humanos.
          example: Bad Request
        message:
          type: string
          description: Mensagem de erro legível com detalhes.
          example: context not found
        error:
          type: string
          description: Descontinuado. Mensagem de erro para compatibilidade retroativa.
          deprecated: true
        details:
          description: Contexto adicional do erro como pares chave-valor
          additionalProperties: {}
          type: object
  examples:
    ErrorM0103:
      summary: Insufficient Privileges
      value:
        code: MTCH-0004
        title: Forbidden
        message: >-
          You do not have the necessary permissions to perform this action.
          Please contact your administrator if you believe this is an error.
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: 'Autenticação por Bearer token (formato: "Bearer {token}")'

````