Skip to main content
GET
/
api
/
v1
/
audit
/
logs
curl -X GET "https://olive-gateway-a6ba.onrender.com/api/v1/audit/logs?event_type=PAYMENT_EXECUTED&limit=50" \
  -H "Authorization: Bearer ADMIN_JWT"
{
  "logs": [
    {
      "id": "log_123",
      "event_type": "PAYMENT_EXECUTED",
      "actor": "sub_abc123",
      "actor_type": "subscriber",
      "details": {
        "amount": 5000,
        "currency": "SLE",
        "recipient": "sub_xyz789"
      },
      "ip_address": "192.168.1.1",
      "timestamp": "2025-01-15T10:30:00Z"
    },
    {
      "id": "log_124",
      "event_type": "USER_LOGIN",
      "actor": "admin@olive.sl",
      "actor_type": "admin",
      "details": {
        "success": true,
        "user_agent": "Mozilla/5.0..."
      },
      "ip_address": "10.0.0.1",
      "timestamp": "2025-01-15T10:25:00Z"
    }
  ],
  "total": 1500
}
Query system audit logs for compliance and monitoring. Only administrators can access audit logs.

Request

Authorization
string
required
Bearer <token> - Admin JWT

Query Parameters

user_id
string
Filter by user ID
event_type
string
Filter by event type (e.g., PAYMENT_EXECUTED, USER_LOGIN)
from
string
Start date (ISO 8601)
to
string
End date (ISO 8601)
limit
integer
Results limit (default: 50, max: 500)
offset
integer
Pagination offset

Response

logs
array
Array of audit log entries
total
integer
Total number of matching logs

Examples

curl -X GET "https://olive-gateway-a6ba.onrender.com/api/v1/audit/logs?event_type=PAYMENT_EXECUTED&limit=50" \
  -H "Authorization: Bearer ADMIN_JWT"
{
  "logs": [
    {
      "id": "log_123",
      "event_type": "PAYMENT_EXECUTED",
      "actor": "sub_abc123",
      "actor_type": "subscriber",
      "details": {
        "amount": 5000,
        "currency": "SLE",
        "recipient": "sub_xyz789"
      },
      "ip_address": "192.168.1.1",
      "timestamp": "2025-01-15T10:30:00Z"
    },
    {
      "id": "log_124",
      "event_type": "USER_LOGIN",
      "actor": "admin@olive.sl",
      "actor_type": "admin",
      "details": {
        "success": true,
        "user_agent": "Mozilla/5.0..."
      },
      "ip_address": "10.0.0.1",
      "timestamp": "2025-01-15T10:25:00Z"
    }
  ],
  "total": 1500
}

Event Types

Event TypeDescription
USER_LOGINUser login attempt
USER_LOGOUTUser logout
USER_CREATEDNew user created
PAYMENT_EXECUTEDPayment processed
TRANSFER_COMPLETEDTransfer completed
SUBSCRIBER_REGISTEREDNew subscriber
SUBSCRIBER_BLOCKEDSubscriber blocked
CARD_LINKEDCard linked to subscriber
COMPLIANCE_ALERTCompliance alert triggered
API_KEY_CREATEDAPI key generated

Errors

StatusCodeDescription
400INVALID_REQUESTInvalid query parameters
401UNAUTHORIZEDNot authenticated
403FORBIDDENNot authorized to access logs