Get audit log

Endpoint

GET /clients/business/audits/{auditId}

Path parameters

string

required

The unique ID of the audit log entry to retrieve.

Headers

string

required

Your public API key.

string

required

Your API secret. Use a stl_test_... value in sandbox, stl_live_... in production.

string

required

Your business ID.

Response

boolean

true on success.

string

Human-readable outcome.

string

Unique audit log ID.

string

Email of the user who performed the action.

string

Full name of the user.

string

Description of the action taken.

string

Category of the event.

string

ISO 8601 timestamp of when the action occurred.

string

Role of the user at the time of the action.

string

IP address from which the action was performed.

Code examples

curl -X GET https://sandbox.stellasbank.com/api/v1/clients/business/audits/AUDIT_ID \
  -H "x-api-key: stl_c8e286ca55b0123e0b05da047494f585" \
  -H "x-api-secret: stl_test_6332e4b1dd6c2e5814395b549aec6deb0d0664406c66f2285f95f801c76117c0" \
  -H "businessId: YOUR_BUSINESS_ID"

const res = await fetch(
  "https://sandbox.stellasbank.com/api/v1/clients/business/audits/AUDIT_ID",
  {
    headers: {
      "x-api-key": "stl_c8e286ca55b0123e0b05da047494f585",
      "x-api-secret": "stl_test_6332e4b1dd6c2e5814395b549aec6deb0d0664406c66f2285f95f801c76117c0",
      businessId: "YOUR_BUSINESS_ID",
    },
  }
);
const { data } = await res.json();

import requests

res = requests.get(
    "https://sandbox.stellasbank.com/api/v1/clients/business/audits/AUDIT_ID",
    headers={
        "x-api-key": "stl_c8e286ca55b0123e0b05da047494f585",
        "x-api-secret": "stl_test_6332e4b1dd6c2e5814395b549aec6deb0d0664406c66f2285f95f801c76117c0",
        "businessId": "YOUR_BUSINESS_ID",
    },
)
print(res.json()["data"])

Example response

{
  "status": true,
  "message": "Audit log retrieved successfully",
  "data": {
    "id": "audit_001",
    "email": "ada@example.com",
    "user": "Ada Lovelace",
    "action": "Initiated a transfer of ₦1,100",
    "type": "transaction",
    "date": "2024-06-09T14:22:00.000Z",
    "role": "Admin",
    "ipAddress": "102.89.23.44"
  }
}

Overview

Members

Business

Virtual accounts

Funds

Bulk transfers

Disputes

Subscriptions

Payouts

Audit logs

Settings

Endpoint

Path parameters

Headers

Response

Code examples

Example response

​Endpoint

​Path parameters

​Headers

​Response

​Code examples

​Example response

Endpoint

Path parameters

Headers

Response

Code examples

Example response