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

# Obtener un registro de auditoría por ID

> Utilice este endpoint para recuperar los detalles de una entrada específica del registro de auditoría por su identificador. Los registros de auditoría contienen registros inmutables de todas las operaciones del sistema para fines de cumplimiento y depuración.



## OpenAPI

````yaml es/openapi/v3-current/matcher.yaml get /v1/governance/audit-logs/{id}
openapi: 3.1.0
info:
  title: Matcher APIs
  description: >-
    Referencia completa de la API para el motor de conciliación Matcher, que
    proporciona conciliación automatizada de transacciones entre Midaz Ledger y
    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: Obtener un registro de auditoría por ID
      description: >-
        Utilice este endpoint para recuperar los detalles de una entrada
        específica del registro de auditoría por su identificador. Los registros
        de auditoría contienen registros inmutables de todas las operaciones del
        sistema para fines de cumplimiento y depuración.
      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 la solicitud fue exitosa y la respuesta contiene los
            datos esperados.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AuditLogResponse'
        '400':
          description: La solicitud contiene parámetros o cuerpo no válidos.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: La solicitud no tiene credenciales de autenticación válidas.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: No tiene permiso para acceder a este recurso.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                ErrorM0103:
                  $ref: '#/components/examples/ErrorM0103'
        '404':
          description: El recurso solicitado no fue encontrado.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Ocurrió un error inesperado en el servidor.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - BearerAuth: []
components:
  schemas:
    AuditLogResponse:
      description: >-
        Entrada inmutable del registro de auditoría para seguimiento de
        gobernanza
      properties:
        action:
          description: Acción que se realizó
          example: CREATE
          type: string
        actorId:
          description: ID del actor que realizó la acción
          example: user@example.com
          type: string
        changes:
          description: Cambios realizados en la entidad
          items:
            type: integer
          type: array
        createdAt:
          description: Marca de tiempo de creación en formato RFC3339
          example: '2025-01-15T10:30:00.000Z'
          type: string
        entityId:
          description: ID de la entidad que fue modificada
          example: 019c96a0-10a0-72d2-9fb0-2b7de8093182
          type: string
        entityType:
          description: Tipo de entidad que fue modificada
          example: reconciliation_context
          type: string
        id:
          description: Identificador único de la entrada del registro de auditoría
          example: 019c96a0-0b61-71a2-8595-dde786b5bcc6
          type: string
        tenantId:
          description: ID de tenant propietario de esta entrada del registro de auditoría
          example: 019c96a0-0a98-7287-9a31-786e0809c769
          type: string
        truncated:
          description: >-
            Verdadero cuando el diff de auditoría original superó el límite del
            payload y fue reemplazado por un marcador de truncamiento
          example: false
          type: boolean
        originalSize:
          description: >-
            Tamaño en bytes del diff original antes del truncamiento; cero
            cuando no se truncó
          example: 0
          format: int64
          type: integer
      type: object
    ErrorResponse:
      description: Respuesta de error estándar devuelta por todos los endpoints de la API
      type: object
      required:
        - code
        - title
        - message
      properties:
        code:
          type: string
          description: Código de error de aplicación estable.
          example: MTCH-0001
        title:
          type: string
          description: Título de error legible por humanos.
          example: Bad Request
        message:
          type: string
          description: Mensaje de error legible con detalles.
          example: context not found
        error:
          type: string
          description: >-
            Obsoleto. Mensaje de error para compatibilidad con versiones
            anteriores.
          deprecated: true
        details:
          description: Contexto de error adicional como pares clave-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: 'Autenticación con token Bearer (formato: "Bearer {token}")'

````