List Admin Audit Logs

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

Retrieves audit logs for administrators. Allows querying by target ID or trace ID to investigate user activity across the platform. Results include target snapshots with additional context about the target at the time of the action. At least one of targetId or traceId must be provided.

Query Parameters

  • targetIdstring
    Filter by target ID (32-character string). Returns audit logs where this ID is either the target or the actor.
    Min length: >= 32 characters
    Max length: <= 32 characters
  • traceIdstring
    Filter by trace ID to find all related audit logs in a request chain
  • 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)
    Min length: >= 32 characters
    Max length: <= 32 characters
  • 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

200 Response

auditLogs array[object] required
Audit log entry for admin API with extended information
id string
Unique identifier for this audit log entry
actor object required
Actor information for admin audit logs (username may be masked)
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
otelTraceId string
OpenTelemetry trace ID for distributed tracing
targetSnapshot object
Snapshot of target entity details at the time of the audit log
requestDetails object
Details about the HTTP request that generated this audit log
data object
Additional data associated with the audit log event
nextBatchPrevId string
Pagination cursor - pass as prevId for next page (32-character string)
Min length: >= 32 characters
Max length: <= 32 characters
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

500 Response

error string
Error message
message string
Detailed error message