User activity log


User Activity Log

This endpoint returns a paginated audit trail of authorization control events associated with a given user. Each record captures the type of action performed, the previous value, the new value, and the actor who made the change. Use this endpoint to monitor changes to spend rules, payment cards, subprofiles, financial accounts, and other controlled resources.

Endpoint

GET /api/authorizationControls/USERID/activity

Authentication

Bearer token required. Obtain via:

POST https://api.banking.netevia.dev/api/auth/v2

Include in header: Authorization: Bearer {token} Token lifetime: 10 minutes. Refresh via POST /api/auth/refresh.

When to use

Use this endpoint when you need to audit changes made to a user's authorization controls — for example, to review who modified spend limits, blocked merchant categories, updated payment card statuses, or changed subprofile access. It is also useful for compliance reporting and detecting unauthorized configuration changes on business accounts.

Path Parameters

ParameterTypeRequiredDescription
userIdinteger (int32)YesThe unique identifier of the user whose activity log is being retrieved.

Query Parameters

ParameterTypeRequiredDescription
countinteger (int32)NoNumber of records to return per page. Defaults to 50.
skipinteger (int32)NoNumber of records to skip for pagination. Defaults to 0.

Response

200 OK

Envelope fields:

FieldTypeDescription
totalCountintegerTotal number of activity records available for this user.
errorMessagestring | nullError message if the request partially failed; otherwise null.
cursorstring | nullPagination cursor for fetching the next page of results; may be null.
recordsarray | nullList of audit activity records. See record fields below.

Record fields (records[]):

FieldTypeDescription
performedBystring (date-time)Timestamp of when the action was performed.
activityTypestring (enum)The type of authorization control action. See activity type values below.
oldValuestring | nullThe previous value before the change was applied; null if not applicable.
newValuestring | nullThe new value set by the action; null if not applicable.

activityType enum values:

ValueDescription
AdminPanel_ModuleAccessModule access configuration changed via admin panel.
AdminPanel_LocalizationLocalization settings changed via admin panel.
AdminPanel_UserAccessUser access permissions changed via admin panel.
AdminPanel_FAQFAQ content updated via admin panel.
AdminPanel_TicketTopicSupport ticket topic changed via admin panel.
AdminPanel_MCCMerchant Category Code settings changed via admin panel.
Teams_DepartmentDepartment record created or updated.
Teams_SubprofileSubprofile (authorized user) created or updated.
Teams_Subprofile_RestoreSubprofile restored after removal.
Teams_Subprofile_DepartmentSubprofile department association changed.
Teams_Subprofile_AddressSubprofile address updated.
Teams_Subprofile_PhoneSubprofile phone number updated.
Teams_Subprofile_FinancialAccountSubprofile linked to or unlinked from a financial account.
Teams_Subprofile_PaymentCardSubprofile linked to or unlinked from a payment card.
PaymentCardPayment card created or updated.
PaymentCard_NamePayment card name changed.
PaymentCard_PinPayment card PIN changed.
PaymentCard_StatusPayment card status changed (e.g., activated, suspended, closed).
PaymentCard_OrderPayment card order placed.
FinancialAccountFinancial account created or updated.
SpendRules_AmountLimitsPer-transaction spend limit updated.
SpendRules_AmountLimitMonthlyMonthly spend limit updated.
SpendRules_AtmDailyLimitATM daily withdrawal limit updated.
SpendRules_MerchantCategoryAllowed merchant category list updated.
SpendRules_MerchantCategory_BlockedBlocked merchant category list updated.
SpendRules_MerchantCountryAllowed merchant country list updated.
SpendRules_MerchantCountry_BlockedBlocked merchant country list updated.
SpendRules_DetachA specific spend rule detached from a card or account.
SpendRules_Detach_AllAll spend rules detached from a card or account.
{
  "totalCount": 3,
  "errorMessage": null,
  "cursor": null,
  "records": [
    {
      "performedBy": "2024-11-15T10:32:00Z",
      "activityType": "SpendRules_AmountLimits",
      "oldValue": "500.00",
      "newValue": "1000.00"
    },
    {
      "performedBy": "2024-11-14T08:15:22Z",
      "activityType": "PaymentCard_Status",
      "oldValue": "SUSPENDED",
      "newValue": "ACTIVE"
    },
    {
      "performedBy": "2024-11-12T14:05:10Z",
      "activityType": "Teams_Subprofile_PaymentCard",
      "oldValue": null,
      "newValue": "XXXX-XXXX-XXXX-7890"
    }
  ]
}

Error Codes

CodeWhen it happens
400userId is missing, not a valid integer, or count/skip values are negative.
401Token missing, expired, or invalid.
403Insufficient permissions to view this user's activity log.
404No user found with the specified userId.
500Internal server error.

Common Mistakes

  • Passing a non-integer value for userId, count, or skip will result in a 400 error — all three must be valid int32 values.
  • Omitting pagination parameters is valid (defaults apply), but if totalCount exceeds 50 you must increment skip by count on each subsequent request to page through all records.
  • The performedBy field is typed as date-time in the schema and represents a timestamp, not a user identifier — do not treat it as a user name or ID.
  • This endpoint is scoped to authorization control events only; it does not return a general transaction history or login activity log.

Related Endpoints

  • GET /api/authorizationControls/USERID — Retrieve the current authorization controls configuration for a user.
  • POST /api/authorizationControls/USERID — Create or update authorization controls for a user.
  • GET /api/authorizationControls/USERID/spendRules — Retrieve active spend rules attached to a user.

Example

curl -X GET "https://api.banking.netevia.dev/api/authorizationControls/98765/activity?count=25&skip=0" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json"
Path Params
int32
required
Query Params
int32
Defaults to 50
int32
Defaults to 0
Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Response

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
text/plain
application/json
text/json