REST API›Enterprise›User

GET

List access tokens

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 Params

  • limit string number
    Maximum number of results to return (server-configured default, max: 200)
  • prevId string
    Cursor for pagination; use the nextBatchPrevId value from the previous response
  • sort string enum
    Sort order for results. ASC (default) returns oldest-first; DESC returns newest-first
    ASCDESC

Responses

200
OK

Response Body

object

  • accessTokens array of objects required
    accessTokens object
    • id string required

      matches ^[0-9a-f]{32}$

    • isExtensible boolean required
    • adminScope string enum
      readfull
    • bitgoAdminPermissions array of strings
    • 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
    • ipRestrict array of strings
    • label string
    • origin string
      BitGo environment that issued this token
    • token string
    • scope array of strings
    • unlock object
      unlock object
      • spendingLimits map of objects
        spendingLimits object
        • <key> object
          value object
          • txCount number
            The transaction count limit for the coin
          • txValue number
            The transaction value limit for the coin
          • txValueLimit number
            The maximum transaction value limit for the coin
      • allErc20TokensLimit object
        allErc20TokensLimit object
        • enabled boolean required
          Indicates if the limit is enabled for all ERC20 tokens
        • txCount number required
          The transaction count limit for all ERC20 tokens
        • txValue string required
          The transaction value limit for all ERC20 tokens
        • txValueLimitInSmallUnits string
          The transaction value limit in small units for all ERC20 tokens
        • maxLimit boolean
          Indicates if the maximum limit is enabled
      • expires string date-time
      • time string date-time
      • txCount number
      • txValue number
      • txValueLimit number
    • user string

      matches ^[0-9a-f]{32}$

    • oauth object
      oauth object
      • oauthRequired boolean
      • expires string date-time
    • isMobileAccessToken boolean
      Flag indicating if this token was created via mobile session endpoint
  • nextBatchPrevId string
400
Bad Request

Response Body

object

  • name string
    Error code
  • context map of objects required
    Properties that apply to a specific error name
    context object
    • <key> object
  • error string required
    Human-readable error message
  • requestId string required
    Client request id
401
Unauthorized

Response Body

object

  • name string
    Error code
  • context map of objects required
    Properties that apply to a specific error name
    context object
    • <key> object
  • error string required
    Human-readable error message
  • requestId string required
    Client request id
403
Forbidden

Response Body

object

  • name string
    Error code
  • context map of objects required
    Properties that apply to a specific error name
    context object
    • <key> object
  • error string required
    Human-readable error message
  • requestId string required
    Client request id