List User Audit Logs

get/https:/app.bitgo.com/api/v3/auditlogs

Retrieves audit logs for the authenticated user within an enterprise. Returns audit logs based on the user's role (auditor, admin, or member) with appropriate filtering. Results are paginated and sorted by timestamp in descending order. Requires the user to be an employee with appropriate scopes (auditlogs_view_all or user_manage).

Query Parameters

  • targetIdstring
    Filter by target ID (32-character alphanumeric string)
    Pattern: ^[a-z0-9]+$
    Min length: >= 32 characters
    Max length: <= 32 characters
  • targetTypestring
    Filter by target type
    Enum: user wallet enterprise organization bitgo
  • typestring or array
    Filter by audit log type(s). Can be a single type or array of types.
  • actorIdstring
    Filter by actor ID (32-character alphanumeric string)
    Pattern: ^[a-z0-9]+$
    Min length: >= 32 characters
    Max length: <= 32 characters
  • actorTypestring
    Filter by actor type
    Enum: admin spoofer user bitgo
  • traceIdstring
    Filter by trace ID to find related audit logs
  • dateGtestring<date-time>
    Filter for audit logs on or after this date (ISO 8601 format)
  • dateLtstring<date-time>
    Filter for audit logs before this date (ISO 8601 format)
  • prevIdstring
    Pagination cursor - ID of the last item from the previous page (32-character string)
    Min length: >= 32 characters
    Max length: <= 32 characters
  • timestampstring
    Pagination cursor - timestamp of the last item from the previous page
  • limitintegerDefault: 25
    Maximum number of results to return per page
    Minimum: >= 25
    Maximum: <= 50

200 Response

auditLogsrequired
Audit log entry for user-facing API
id string required
Unique identifier for this audit log entry
Min length: >= 32 characters
Max length: <= 32 characters
actor object required
Actor information for user-facing audit logs (excludes spoofer type)
ip string
IP address of the client
Min length: >= 2 characters
Max length: <= 39 characters
userAgent string
User agent string
sessionId string
Session ID
requestId string required
Request ID
Min length: >= 5 characters
Max length: <= 100 characters
targetId string required
Target entity ID
Min length: >= 32 characters
Max length: <= 32 characters
targetType string required
Type of entity that was the target of the action
Allowed values: user wallet enterprise organization bitgo
timestamp string <date-time>required
Timestamp of the action
type string required
Audit log type
traceId string
Trace ID
data object
Additional data associated with the audit log event
nextBatchPrevId string
Pagination cursor - pass as prevId for next page
nextBatchTimestamp number
Pagination cursor - pass as timestamp for next page

400 Response

error string
Error message
message string
Detailed error message

401 Response

error string
Error message
message string
Detailed error message

404 Response

error string
Error message
message string
Detailed error message