Ctrl+K

List audit logs

get/api/v2/admin/auditlogs

Clients must filter by enterprise.bitgoOrg, enterpriseId, user, or walletId

Query Parameters

  • enterpriseIdarray[string]
    Filter by enterprise.
    Example: 59cd72485007a239fb00282ed480da1f
    Pattern: ^[0-9a-f]{32}$
  • bitgoOrgstring
    Filter by bitgoOrg
    Enum: BitGo Inc BitGo Trust BitGo New York BitGo Germany BitGo Switzerland Frankfurt DE Trust BitGo Sister Trust 1 BitGo Korea BitGo Singapore BitGo Europe ApS BitGo Mena Fze BitGo Custody MENA FZE BitGo India
  • enterprise.bitgoOrgstring
    Filter by the `bitgoOrg` field of the enterprise associated with the audit log
    Enum: BitGo Inc BitGo Trust BitGo New York BitGo Germany BitGo Switzerland Frankfurt DE Trust BitGo Sister Trust 1 BitGo Korea BitGo Singapore BitGo Europe ApS BitGo Mena Fze BitGo Custody MENA FZE BitGo India
  • userarray[string]
    Filter by user.
    Example: 59cd72485007a239fb00282ed480da1f
    Pattern: ^[0-9a-f]{32}$
  • walletIdarray[string]
    Filter by wallet id (v2) or address (v1)

200 Response

logs array[object] required
coin string
A cryptocurrency or token ticker symbol.
Example: btc
data object
Properties that apply to the given audit log type
date string <date-time>
Example: {}
enterpriseId string
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
id string
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
ip string <ipv4>
The client IP that caused the AuditLog entry to be written
Example: 127.0.0.1
target string
Object that the AuditLog entry is associated with
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
type string
Allowed values: addPolicy addPolicyServicePolicy addPolicyServiceSettlement addUser addWebhook adminAddCustomNode adminAddCustomNodeForWallet adminChangeHsmRegionalSettingOnEnterprise adminFreezeUser adminRenameEnterprise adminUpdateBankAccount adminUpdateKycState adminUpdatePasswordReset approveEnterpriseUser approveOrganizationUser approvePolicy approvePolicyServicePolicy approvePolicyServiceSettlement approveTransaction approveUser bitgoSigned bulkCreateOfcWallet changePolicy changePolicyServicePolicy completeReset2FA createAccessToken createBankAccount createEnterprise createPasswordReset createReset2FA createSendLabel createTransaction createWallet deleteAccessToken deleteCustomNode deleteCustomNodeForWallet deletePasswordReset deleteSendLabel externalWithdrawalDetected freezeEnterprise freezeUser freezeWallet institutionalSignupCreateEnterprise labelAddress modifyAccessToken oAuthAuthorize policyServicePolicyUpdated policyUpdated rejectEnterpriseUser rejectOrganizationUser rejectPolicy rejectPolicyServicePolicy rejectPolicyServiceSettlement rejectTransaction rejectUser removeBankAccount removePolicy removePolicyServicePolicy removeUser removeVideoId removeWallet removeWebhook renameWallet shareUser shareUserAccept shareUserCancel shareUserDecline starterSignupCreateEnterprise unlabelAddress updateApprovalsRequired updateBankAccount updateComment updateEnterprise updateEnterpriseUser updateKycState updateNotificationSettings updateSendLabel updateTag updateWalletCoinSpecific upsertRecoveryCodes user2FAAdd user2FARemove userFailedLogin userLogin userPasswordChange userPasswordReset userSettingsChange userSignup userSourceVerified verifyReset2FA viewRecoveryCodes
user string
The user that caused the AuditLog entry to be written
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
walletId string
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
nextBatchPrevId string <uuid>
When a result set is truncated, this field returns the id of the last object in the previous batch. To get the next batch of results, pass this value via the `prevId` query parameter.
Example: 585951a5df8380e0e3063e9f

400 Response

One of
error string required
Human-readable error message
requestId string required
Client request id
context object
Properties that apply to a specific error name
name string required
Error code