> ## 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. # Listar registros de auditoría por entidad > Utilice este endpoint para recuperar todas las entradas del registro de auditoría de una entidad específica. Los resultados están ordenados por fecha de creación de forma descendente. Esto le permite rastrear el historial completo de cambios de cualquier entidad en el sistema. ## OpenAPI ````yaml es/openapi/v3-current/matcher.yaml get /v1/governance/entities/{entityType}/{entityId}/audit-logs 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/entities/{entityType}/{entityId}/audit-logs: get: tags: - Governance summary: Listar registros de auditoría por entidad description: >- Utilice este endpoint para recuperar todas las entradas del registro de auditoría de una entidad específica. Los resultados están ordenados por fecha de creación de forma descendente. Esto le permite rastrear el historial completo de cambios de cualquier entidad en el sistema. operationId: listAuditLogsByEntity parameters: - description: A unique identifier for tracing the request across services. in: header name: X-Request-Id schema: type: string - description: Entity type example: reconciliation_context in: path name: entityType required: true schema: type: string - description: Entity ID in: path name: entityId required: true schema: type: string format: uuid - description: The maximum number of items to include in the response. in: query name: limit schema: type: integer minimum: 1 maximum: 200 default: 20 - description: The cursor value for retrieving the next page of results. in: query name: cursor schema: type: string responses: '200': description: >- Indica que la solicitud fue exitosa y la respuesta contiene los datos esperados. content: application/json: schema: $ref: '#/components/schemas/ListAuditLogsResponse' '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' '500': description: Ocurrió un error inesperado en el servidor. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' security: - BearerAuth: [] components: schemas: ListAuditLogsResponse: description: Lista paginada de entradas del registro de auditoría properties: hasMore: example: true type: boolean items: description: Lista de entradas del registro de auditoría items: $ref: '#/components/schemas/AuditLogResponse' type: array limit: example: 20 maximum: 200 minimum: 1 type: integer nextCursor: example: eyJpZCI6IjEyMyJ9 type: string prevCursor: example: eyJpZCI6IjEyMiJ9 type: string 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 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 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}")' ````