> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloudpay.africa/llms.txt
> Use this file to discover all available pages before exploring further.

# Audit log and sign-ins

> Who did what, when, and from where.

## Audit log

Every change to money, people, keys and settings is written in the same transaction as the change, and can't be edited or deleted by anyone, Cloudpay included. Each record has:

| Field | Meaning |
| - | - |
| `actor` | `member`, `api_key`, `staff` (Cloudpay) or `system`, and who |
| `action`, `entity_type`, `entity_id` | what changed |
| `data` | the details |
| `ip`, `user_agent` | the device it came from |
| `session_id`, `request_id` | the session and request, to trace across logs |

Merchants read theirs at `GET /v1/merchants/{id}/audit` (`audit` permission) and filter by actor, action and date.

## Sign-in history

Every attempt is recorded, including failures: `success`, `bad_credentials`, `locked`, `otp_required`, `otp_failed`, `mfa_required`, `mfa_failed`, `disabled`, with IP, device and place.

* Your own: `GET /v1/auth/login-events` and `GET /v1/auth/sessions`.
* Your team's: `GET /v1/merchants/{id}/members/{partyID}/login-events` and `/sessions` (`members` permission). Signing someone out is audited.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.