Ctrl+K

List access tokens

get/api/v2/user/accesstoken

Returns all non-expired long-lived access tokens for the authenticated user. Results are paginated using cursor-based pagination. Use the prevId query parameter with the nextBatchPrevId value from the previous response to fetch the next page. The default page size is server-configured (currently 100); maximum is 200.

Query Parameters

  • limitstring<number>
    Maximum number of results to return (server-configured default, max: 200)
  • prevIdstring
    Cursor for pagination; use the `nextBatchPrevId` value from the previous response

200 Response

accessTokens array[object] required
id string required
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
isExtensible boolean required
bitgoAdminPermissions array[string]
client string
created string <date-time>
enterprise string
expires string <date-time>
extensionAddress string
ip string <ipv4>
IP address of the client that requested this access token
Example: 127.0.0.1
ipRestrict array[string]
IP addresses or CIDR block of clients that are allowed to use this token
label string
origin string
BitGo environment that issued this token
Example: test.bitgo.com
token string
scope array[string]
Session permissions
Example: ["crypto_compare","user_manage","openid","profile","wallet_create","wallet_manage_all","wallet_approve_all","wallet_spend_all","wallet_edit_all","wallet_view_all"]
unlock object
user string
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
oauth object
isMobileAccessToken boolean
Flag indicating if this token was created via mobile session endpoint
nextBatchPrevId string

400 Response

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

401 Response

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

403 Response

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