Search Audit Logs

This method allows you to track and search through users' activities on the web interface.

Please log in to see full path URL. Learn why.

get

/audit/1/logs

Authorizations:

Scopes:

account-management:manage

audit-logs:read

query Parameters

action	string Enum: "Accept" "Activation" "Add" "Assign" "Buy" "Cancel" "Change" "Clone" "Create" "CreateGenerate" "CreateVersion" "Delete" "DeleteVersion" "Disable" "Download" "Duplicate" "Enable" "Export" "Finish" "Import" "InviteToMobileDemoApplication" "Launch" "LaunchVersion" "Lock" "Login" "Logout" "Merge" "Pause" "Remove" "Request" "Restore" "Schedule" "Sent" "StopVersion" "Successful" "Unlock" "Update" "Updated" "Unsuccessful" "Verify" Example: action=Create User's action. If nothing is provided, logs for all actions are returned.
description	string Example: description=username Description of an action. If nothing is provided, logs for all descriptions are returned.
from	string <date-time> Example: from=2023-01-01T00:00:00.000Z Date and time filter with the following format: `yyyy-MM-dd'T'HH:mm:ss.SSSZ`. If nothing is provided, there will be no lower limit filter applied on a date and time of recorded activity returned in logs.
item	string Enum: "TFA" "Account" "ApiKey" "AutomaticPayment" "BillingAddress" "Blacklist" "Campaign" "Communication" "Company" "CustomField" "Domain" "ExportConfiguration" "Forms" "Keyword" "MobileApplication" "MobileDemoApplication" "Number" "OneTimePayment" "Password" "Person" "Price" "Report" "Segment" "Search" "Tag" "Team" "Template" "URL" "User" "Website" Example: item=User Use it as a filter to apply to the action field to narrow down the logs returned. if nothing is provided, logs with all items are returned.
ipAddress	string Example: ipAddress=127.0.0.1 User's IP address. If nothing is provided, logs for all IP addresses are returned.
limit	integer <int32> [ 1 .. 10000 ] Example: limit=10000 Max number of user activities returned in logs. Accepts values from `1` to `10000`. Defaults to `10000`.
to	string <date-time> Example: to=2023-01-03T00:00:00.000Z Date and time filter with the following format: `yyyy-MM-dd'T'HH:mm:ss.SSSZ`. If nothing is provided, there will be no upper limit filter applied on a date and time of recorded user activity returned in logs.
userKey	string Example: userKey=JD1I2JD9JD3DDHHGKCNN1PK2O1 User's key can be found on the user's profile page at the Infobip portal. If nothing is provided, the logs for all user keys are returned.

Responses

200

List of audit logs.

400

Search result larger than the limit. Limit is 10000.

401

Unauthorized

403

Forbidden

500

Internal Server Error

Request samples

Example

cURL

Copy

curl -L -g 'https://{baseUrl}/audit/1/logs?action=Create&description=username&from=2023-01-01T00%3A00%3A00.000Z&item=User&ipAddress=127.0.0.1&limit=10000&to=2023-01-03T00%3A00%3A00.000Z&userKey=JD1I2JD9JD3DDHHGKCNN1PK2O1' \
-H 'Authorization: {authorization}' \
-H 'Accept: application/json'

Response samples

Content type

application/json

Copy

Collapse all


[
{"action": "Create",
"description": "User 'username' created user!",
"id": "80265c56-b644-4fb9-a5ab-83example5b3384",
"ipAddress": "127.0.0.1",
"item": "User",
"timestamp": "2025-03-12T00:00:00Z",
"username": "username"
}
]

Need assistance

Explore Infobip Tutorials

Encountering issues

Contact our support

What's new? Check out

Release Notes

Unsure about a term? See

Glossary

Research panel

Help shape the future of our products

Learn more

Service status

Privacy documents Terms of use