Transaction request

Get transaction requests by enterprise filtering by wallet permissions

Changed on

Supports both lite and full transaction requests. Use the apiVersion query parameter to filter by version.

get/api/v2/enterprise/{enterpriseId}/txrequests/bypermission

Request

  • Base URL
    https://developers.bitgo.com
  • URL
    https://developers.bitgo.com/api/v2/enterprise/{enterpriseId}/txrequests/bypermission
  • Auth
    none declared

Path parameters

enterpriseIdstring required
Example:59cd72485007a239fb00282ed480da1f

Query parameters

apiVersion'lite' | 'full'

If present, filters transaction requests by the specified API version (lite or full). If not provided, returns all transaction requests regardless of API version.

walletTypesstring[]

If present, filters transaction requests by the specified wallet types

excludeIntentTypesstring[]

If provided, transaction requests with the specified intent types will be excluded.

statesstring[]

If provided, only transaction requests of the specified state will be returned.

  • canceled: Canceled by a wallet spender before approval or sending.
  • delivered: Inserted into the send queue (or rejected by BitGo through circuit breakers). This state is only used with apiVersion "full".
  • failed : Catch-all state indicating an unrecoverable failure (such as a duplicate key error when creating a transfer).
  • initialized: First state when a transaction request is created (before any policy evaluation occurs).
  • pendingApproval: Triggered a policy that requires approval to proceed.
  • pendingDelivery: Requires further action to proceed (such as pending signature, or accepting/rejecting due to triggering a circuit breaker). This state is only used with apiVersion "full".
  • pendingUserCommitment: Ready to receive your user commitments. This state is only used with apiVersion "lite" and EdDSA assets with commitment signing states.
  • pendingUserGShare: Ready to receive your gShare.
  • pendingUserRShare: Ready to receive your rShare.
  • pendingUserSignature: Ready to receive your user signature (get the unsigned transaction from BitGo and sign it). This state is only used with apiVersion "lite" and EdDSA assets without commitment signing states.
  • readyToSend: Ready send (share combination is complete).
  • rejected: Rejected by an approver.
  • signed: All transactions in the transaction request were signed. All future updates will be in the transfer document.
walletPermissionsstring[]

If present, filters transaction requests by wallet permissions. If not present will default to view permissions

limitstring number
Example:5
prevIdstring
Example:59cd72485007a239fb00282ed480da1f
sortBy'id' | 'createdDate'

Optional field to sort by.

sortDirection'ASC' | 'DESC'

Optional direction of sorting.

dateLtstring date-time

Optional get transaction requests less than date

dateGtestring date-time

Optional get transaction requests greater than or equal to date

Response

OK

nextBatchPrevIdstring

Example response

{
  "txRequests": [
    {
      "intent": {
        "messageRaw": "for EVM: test message"
      },
      "txRequestId": "123e4567-e89b-12d3-a456-426614174000",
      "walletId": "59cd72485007a239fb00282ed480da1f",
      "date": "2021-01-01T00:00:00.000Z",
      "createdDate": "2021-01-01T00:00:00.000Z",
      "enterpriseId": "59cd72485007a239fb00282ed480da1f"
    }
  ]
}

Changes

  • 6b6e050a7f84Revision changes
    • info

      added the optional property /////// to the response with the status

    • info

      added the optional property /////// to the response with the status

  • c3028fb3e8dcRevision changes
    • breaking

      added to the //// response property oneOf list for the response status

    • breaking

      added subschema #1 subschema #2 to the ///// response property oneOf list for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the /////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the //////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the //////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the //////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the ///////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the //////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the /////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the /////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the /////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the /////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the //////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the /////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the /////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the /////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the //////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the //////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the /////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the //////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the //////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the ///////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the ///////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the //////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the //////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the //////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the //////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the /////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the /////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the //////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the //////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the //////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the ///////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the /////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the //////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the //////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the //////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the //////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the //////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the //////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the //////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the ///////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the ///////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the //////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the ///////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the ///////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the ///////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the ///////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the //////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the //////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the //////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the //////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the //////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the ///////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the //////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the ///////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the ///////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the ///////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the ///////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the /////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the //////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the //////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the //////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the ///////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the //////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the //////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the //////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the //////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the //////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the ///////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the //////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the ///////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the /////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the /////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the /////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the /////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the /////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the /////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the /////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the /////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the //////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the /////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the /////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the /////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the /////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the /////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the /////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the /////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the /////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the /////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the /////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the //////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the //////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the //////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the ///////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the ///////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the ///////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the /////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the //////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the /////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the //////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the ///////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the //////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the //////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the ///////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the ///////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the ///////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the //////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the /////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the ///////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the //////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the ///////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the ///////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the ///////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the /////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the ///////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the /////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the //////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the /////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the /////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the /////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the //////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the //////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the ///////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the ///////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the ///////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the /////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the //////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the //////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the /////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the //////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the //////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the //////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the //////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the //////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the //////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the ///////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the ///////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the ///////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the //////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the ///////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the ///////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the //////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the //////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the ///////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the ///////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the /////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the /////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the /////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the ///////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the //////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the /////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the /////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the /////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the /////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the /////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the /////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the ////////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the //////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the ////////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the //////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the //////// response property for the response status

    • warning

      added the new cantonBroadridgeStandingDelegation enum value to the ///// response property for the response status

    • info

      added the enum value cantonBroadridgeStandingDelegation to the property items/ of the query request parameter excludeIntentTypes

    • info

      added the optional property //////// to the response with the status

    • info

      removed subschema #1 subschema #2 from the ///// response property oneOf list for the response status