Audit Log

Read the merchant's audit log of account actions.

List audit log

POSThttps://api.gobtcpay.com/public/api/v1.2/merchant/audit/list

Returns the merchant's audit log with optional pagination and filters (action, dateRange). Each entry records the actor, action, detail, and request metadata. Returns items and totalCount.

Authorization: merchantAuth

Body required

application/json

paginationobject

filtersobject

Responses

idstringrequired

Example:3fa85f64-5717-4562-b3fc-2c963f66afa6

resultobjectrequired

POST /merchant/audit/list

cURL

curl -X POST "$BASE_URL/merchant/audit/list" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -d '{
  "pagination": {
    "limit": 20,
    "skip": 0
  },
  "filters": {
    "action": "string",
    "dateRange": {
      "start": 1718012345,
      "end": 1718012345
    }
  }
}'

200 Successful response

JSON

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "result": {
    "$case": "success",
    "success": {
      "items": [
        {
          "at": 1718012345,
          "action": "string",
          "actorUserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "actorApiKeyId": "possk_live_3fa85f6457174562b3fc2c963f66afa6",
          "actorName": "string",
          "detail": "string",
          "ip": "string",
          "userAgent": "string"
        }
      ],
      "totalCount": 0
    }
  }
}