Get Subprofile User Activity
Returns a paginated list of audit log entries for a specific subprofile (authorized user) associated with a business customer account. Each entry records an action taken, its details, the prior value before the change, and the actor who performed it. This endpoint is useful for compliance auditing, support investigations, and monitoring access or configuration changes made by or to authorized users.
Endpoint
GET /api/subProfiles/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 a business account owner or administrator needs to review the activity history of an authorized user, such as after a suspected unauthorized change or as part of a periodic compliance review. It is also useful for support teams investigating disputes or configuration discrepancies related to a specific subprofile, financial account, payment card, or spend rule.
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| userId | integer (int32) | Yes | The numeric ID of the subprofile (authorized user) whose activity log is being retrieved. |
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| dateFrom | string (date-time) | No | Filter results to entries created on or after this date-time (ISO 8601 format). |
| dateTo | string (date-time) | No | Filter results to entries created on or before this date-time (ISO 8601 format). |
| auditType | string (enum) | No | Filter by a specific type of audit event. See allowed values below. |
| skip | integer (int32) | No | Number of records to skip for pagination. Default: 0. |
| take | integer (int32) | No | Maximum number of records to return. Default: 100. |
Allowed values for auditType:
AdminPanel_ModuleAccessAdminPanel_LocalizationAdminPanel_UserAccessAdminPanel_FAQAdminPanel_TicketTopicAdminPanel_MCCTeams_DepartmentTeams_SubprofileTeams_Subprofile_RestoreTeams_Subprofile_DepartmentTeams_Subprofile_AddressTeams_Subprofile_PhoneTeams_Subprofile_FinancialAccountTeams_Subprofile_PaymentCardPaymentCardPaymentCard_NamePaymentCard_PinPaymentCard_StatusPaymentCard_OrderFinancialAccountSpendRules_AmountLimitsSpendRules_AmountLimitMonthlySpendRules_AtmDailyLimitSpendRules_MerchantCategorySpendRules_MerchantCategory_BlockedSpendRules_MerchantCountrySpendRules_MerchantCountry_BlockedSpendRules_DetachSpendRules_Detach_All
Response
200 OK
Returns an array of audit log activity objects.
| Field | Type | Description |
|---|---|---|
| createdDate | string (date-time) | The date and time when the activity was recorded. |
| action | string | null | The name or type of action that was performed. |
| details | string | null | Additional descriptive details about the action. |
| oldValue | string | null | The previous value before the change was applied, if applicable. |
| user | string | null | The identifier of the user who performed the action. |
[
{
"createdDate": "2024-11-15T10:32:00Z",
"action": "Teams_Subprofile_PaymentCard",
"details": "Payment card XXXX-XXXX-XXXX-4321 attached to subprofile",
"oldValue": null,
"user": "[email protected]"
},
{
"createdDate": "2024-11-14T08:15:00Z",
"action": "SpendRules_AmountLimits",
"details": "Daily spend limit updated to $500",
"oldValue": "$200",
"user": "[email protected]"
},
{
"createdDate": "2024-11-13T14:05:00Z",
"action": "PaymentCard_Status",
"details": "Card status changed to Suspended",
"oldValue": "Active",
"user": "[email protected]"
}
]Error Codes
| Code | When it happens |
|---|---|
| 400 | Invalid query parameter format, such as a malformed date-time string or an unrecognized auditType value. |
| 401 | Token missing, expired, or invalid. |
| 403 | Insufficient permissions — the authenticated partner does not have access to this subprofile's data. |
| 404 | No subprofile found matching the provided userId. |
| 500 | Internal server error. |
Common Mistakes
- Providing a
dateFromvalue that is later thandateTowill return an empty result set rather than an error — always verify the date range is logically ordered. - The
userIdrefers to the subprofile's internal numeric ID, not a username or email address; using any other identifier type will result in a 404 or incorrect results. - Omitting both
skipandtakereturns up to the default of 100 records — for accounts with a long audit history, use pagination to retrieve all entries. - The
auditTypefilter is case-sensitive; use the exact enum string values listed above. - Tokens expire after 10 minutes — refresh via
POST /api/auth/refreshbefore making calls if the token may have expired.
Related Endpoints
GET /api/subProfiles— List all subprofiles for a business accountGET /api/subProfiles/USERID— Retrieve details for a specific subprofilePOST /api/subProfiles— Create a new authorized user (subprofile)PUT /api/subProfiles/USERID— Update an existing subprofile
Example
curl -X GET "https://api.banking.netevia.dev/api/subProfiles/4821/activity?dateFrom=2024-11-01T00%3A00%3A00Z&dateTo=2024-11-30T23%3A59%3A59Z&auditType=PaymentCard_Status&skip=0&take=50" \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json"