auth.v1.SubaccountViewService
ListSubaccountActivity
List audit and activity events for a sub-account.
Request
curl --request POST \ \
--url 'https://api.testnet.polyester.com/auth.v1.SubaccountViewService/ListSubaccountActivity' \
--header 'Content-Type: application/json' \
--header 'Connect-Protocol-Version: 1' \
--data '{
"limit": 100,
"pageToken": "eyJvZmZzZXQiOjEwMH0",
"subaccountId": "6789012345678"
}'Responses
{
"events": [
{
"actorAccountId": "7563897446546",
"createdAt": "2025-01-01T00:00:00Z",
"entityKind": "ACTIVITY_ENTITY_ACCOUNT",
"eventAction": "ACTIVITY_ACTION_CREATED",
"ip": "203.0.113.42",
"payloadJson": "{\"action\":\"member_role_updated\",\"role\":\"TRADER\"}",
"source": "ACTIVITY_SOURCE_WEB",
"userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 Chrome/126.0 Safari/537.36"
}
],
"nextPageToken": "eyJvZmZzZXQiOjIwMH0"
}auth.v1.ListSubaccountEventsRequestauth.v1.ListSubaccountEventsResponseTarget sub-account (opaque ID).
Maximum number of events to return. Defaults to 50 when omitted; maximum is 200.
Opaque keyset cursor from a previous response. The cursor is exclusive and bound to the authenticated account and requested sub-account.
Time when the event occurred.
Category of entity affected by the event.
Action recorded for the entity.
Client channel from which the event originated.
Origin IP address. Masked for non-owner and non-admin callers.
User agent associated with the event, when available.
Account that performed the action (opaque ID).
Structured event details as a JSON string. Maximum 64 KiB (65536 UTF-8 bytes).
Opaque cursor for the next page. Empty when no more results exist.
| Key | HTTP status | Connect code | Error | When |
|---|---|---|---|---|
| unauthenticated | 401 | unauthenticated | Unauthenticated | Authentication required. |
| permission-denied | 403 | permission_denied | Permission Denied | Permission denied. |
| invalid-argument | 400 | invalid_argument | Invalid Argument | Invalid argument. |
| not-found | 404 | not_found | Not Found | Not found. |
| unavailable | 503 | unavailable | Unavailable | Service unavailable. |