Skip to main content
GET
/
admin
/
audit-logs
Logs de auditoría
curl --request GET \
  --url https://api.example.com/admin/audit-logs
{
  "data": [
    {
      "id": "log_abc123",
      "userId": "usr_abc123",
      "action": "user.login",
      "resource": "auth",
      "details": {
        "ip": "192.168.1.1",
        "userAgent": "Mozilla/5.0"
      },
      "createdAt": "2026-03-30T14:00:00Z"
    },
    {
      "id": "log_def456",
      "userId": "usr_abc123",
      "action": "merchant.create",
      "resource": "merchants",
      "details": {
        "merchantId": "merch_abc123",
        "name": "Mi Tienda Online"
      },
      "createdAt": "2026-03-30T13:00:00Z"
    }
  ],
  "page": 1,
  "limit": 20,
  "total": 2
}
Requiere autenticación con Bearer token y rol ADMIN.
page
integer
Número de página. Por defecto 1.
limit
integer
Cantidad de resultados por página. Por defecto 20.
userId
string
Filtrar por identificador del usuario que realizó la acción.
action
string
Filtrar por tipo de acción (ej: user.login, merchant.create, transaction.refund).

Respuesta

La respuesta es un array de registros de auditoría:
id
string
Identificador único del registro de auditoría.
userId
string
Identificador del usuario que realizó la acción.
action
string
Tipo de acción realizada.
resource
string
Recurso afectado por la acción.
details
object
Detalles adicionales de la acción realizada.
createdAt
string
Fecha del evento en formato ISO 8601.
{
  "data": [
    {
      "id": "log_abc123",
      "userId": "usr_abc123",
      "action": "user.login",
      "resource": "auth",
      "details": {
        "ip": "192.168.1.1",
        "userAgent": "Mozilla/5.0"
      },
      "createdAt": "2026-03-30T14:00:00Z"
    },
    {
      "id": "log_def456",
      "userId": "usr_abc123",
      "action": "merchant.create",
      "resource": "merchants",
      "details": {
        "merchantId": "merch_abc123",
        "name": "Mi Tienda Online"
      },
      "createdAt": "2026-03-30T13:00:00Z"
    }
  ],
  "page": 1,
  "limit": 20,
  "total": 2
}