Stablecoin

List stablecoin orders by enterprise

Changed on

Retrieves a list of orders for a specific enterprise.

get/api/stablecoin/v1/enterprise/{enterpriseId}/orders

Request

  • Base URL
    https://developers.bitgo.com
  • URL
    https://developers.bitgo.com/api/stablecoin/v1/enterprise/{enterpriseId}/orders
  • Auth
    none declared

Path parameters

enterpriseIdstring required
Example:67bc4ae090e8af8f9b412d3d67e85252

Enterprise id

Query parameters

searchLabelstring
Example:512f64d10b5f358f6dbf3303f90013cfa46006b02a03282456d6bd6432cc5daf

SearchLabel can represent either an Order Id or a Transaction Id.

idsstring

Specific order identifiers

stablecoinAssetIdstring
Example:d1c27189-764c-4197-af06-e2623658f410

Stablecoin asset identifier

string[]
OR
'gousd' | 'usd1' | 'sofid' | 'cusd' | 'fyusd' | 'qxmp' | 'scaasacme' | 'usd'

Base asset type(s) to filter orders across all chains

type'mint' | 'burn' | 'reward'
Example:mint

Order type

string[]
OR
'created' | 'confirmed_fiat_deposit' | 'confirmed_token_deposit' | 'initiated_burn_token_transfer' | 'completed_burn_token_transfer' | 'approved_mint' | 'triggering_mint' | 'triggering_burn' | 'completed_burn' | 'approved_client_disbursal' | 'initiated_client_disbursal' | 'fulfilled' | 'failed_mint_initiation' | 'failed_mint_transaction' | 'failed_burn_transaction' | 'failed_burn_token_transfer' | 'failed_to_mint' | 'failed_to_burn' | 'failed_to_initiate_disbursal' | 'failed_to_complete_disbursal' | 'rejected' | 'failed' | 'expired' | 'triggering_mint_request' | 'completed_mint_request' | 'triggering_mint_offer' | 'completed_mint_offer' | 'triggering_mint_accept' | 'completed_mint_accept' | 'triggering_mint_transfer' | 'failed_to_mint_request' | 'failed_to_mint_offer' | 'failed_to_mint_accept' | 'failed_to_mint_transfer' | 'rejected_mint_transfer' | 'cancelled_mint_transfer' | 'expired_mint_transfer' | 'triggering_burn_request' | 'completed_burn_request' | 'triggering_burn_accept' | 'failed_to_burn_request' | 'failed_to_burn_accept' | 'pending_policy_approval' | 'policy_rejected'

Order processing status

fromDatestring date-time
Example:2025-05-24T07:28:17.042Z

Start date for order search

toDatestring date-time
Example:2025-06-23T07:28:17.042Z

End date for order search

limitstring
Example:10

Maximum results per page

skipstring
Example:0

Results to skip

sortBy'createdAt'
Example:createdAt

Field name for sorting

sortOrder'ASC' | 'DESC'
Example:DESC

Sort direction

Response

OK

sourceWalletIdstring

Source wallet identifier for the order

destinationWalletIdstring

Destination wallet identifier for go_account type

destinationAddressstring

Destination blockchain address

userIdstring

User identifier who initiated the order

clientDepositTxHashstring

Transaction hash of the client deposit

metadatastring

Additional metadata about the order

orderMethod'issuer_direct' | 'client_deposit'

How the order was initiated: issuer-direct or standard client deposit flow

createdAtstring date-time

Timestamp when the order was created

updatedAtstring date-time

Timestamp when the order was last updated

memostring

Optional free-text memo or comment annotating the order.

pendingApprovalIdstring

The id of the pending approval created for the order, if policy evaluation required one

idstring uuid required

Unique identifier for the order

type'mint' | 'burn' | 'reward' required

Type of order operation

status'created' | 'confirmed_fiat_deposit' | 'confirmed_token_deposit' | 'initiated_burn_token_transfer' | 'completed_burn_token_transfer' | 'approved_mint' | 'triggering_mint' | 'triggering_burn' | 'completed_burn' | 'approved_client_disbursal' | 'initiated_client_disbursal' | 'fulfilled' | 'failed_mint_initiation' | 'failed_mint_transaction' | 'failed_burn_transaction' | 'failed_burn_token_transfer' | 'failed_to_mint' | 'failed_to_burn' | 'failed_to_initiate_disbursal' | 'failed_to_complete_disbursal' | 'rejected' | 'failed' | 'expired' | 'triggering_mint_request' | 'completed_mint_request' | 'triggering_mint_offer' | 'completed_mint_offer' | 'triggering_mint_accept' | 'completed_mint_accept' | 'triggering_mint_transfer' | 'failed_to_mint_request' | 'failed_to_mint_offer' | 'failed_to_mint_accept' | 'failed_to_mint_transfer' | 'rejected_mint_transfer' | 'cancelled_mint_transfer' | 'expired_mint_transfer' | 'triggering_burn_request' | 'completed_burn_request' | 'triggering_burn_accept' | 'failed_to_burn_request' | 'failed_to_burn_accept' | 'pending_policy_approval' | 'policy_rejected' required

Current status of the order

enterpriseIdstring required

The Enterprise ID

fromAssetIdstring uuid required

Source asset identifier

fromAmountstring required

Amount to be transferred from source asset, specified in its lowest denomination.

toAssetIdstring uuid required

Destination asset identifier

toAmountstring required

Amount to be received in destination asset

destinationType'go_account' | 'address' | 'wallet' required

Type of destination for the order

Example response

[
  {
    "sourceWalletId": "67bc4b038f5408faefbfc8edcf6e6577",
    "destinationWalletId": "67bc4b038f5408faefbfc8edcf6e6577",
    "destinationAddress": "default_address",
    "userId": "677cfdceca8396cf5f7534ddeb8d11e3",
    "clientDepositTxHash": "512f64d10b5f358f6dbf3303f90013cfa46006b02a03282456d6bd6432cc5daf",
    "orderHistories": [
      {
        "status": "created",
        "timestamp": "2025-04-04T09:25:48.216Z"
      }
    ],
    "transactions": [
      {
        "txId": "512f64d10b5f358f6dbf3303f90013cfa46006b02a03282456d6bd6432cc5daf",
        "orderId": "95bdbd9c-9cdc-41a4-ae70-165387b7aa51",
        "assetId": "08c1271e-b15d-4af8-8929-f75383903da4",
        "type": "clientDeposit",
        "sender": "client",
        "senderType": "go_account",
        "senderId": "67bc4b038f5408faefbfc8edcf6e6577",
        "sendAmount": "500",
        "receiver": "trust",
        "receiverType": "go_account",
        "receiverId": "6698e670115059e2efe672436a3aea3b",
        "receiveAmount": "500",
        "status": "confirmed",
        "createdAt": "2025-04-04T09:26:21.600Z",
        "updatedAt": "2025-04-04T09:26:21.600Z"
      }
    ],
    "orderMethod": "issuer_direct",
    "createdAt": "2025-04-04T09:25:48.216Z",
    "updatedAt": "2025-04-04T09:55:09.136Z",
    "memo": "Payment for invoice #1234",
    "pendingApprovalId": "677cfdceca8396cf5f7534ddeb8d11e3",
    "id": "95bdbd9c-9cdc-41a4-ae70-165387b7aa51",
    "type": "mint",
    "status": "fulfilled",
    "enterpriseId": "67bc4ae090e8af8f9b412d3d67e85252",
    "fromAssetId": "08c1271e-b15d-4af8-8929-f75383903da4",
    "fromAmount": "500",
    "toAssetId": "49ff49ea-3355-4717-bbb0-5e8f5cae2202",
    "toAmount": "5000000",
    "destinationType": "go_account",
    "fee": {
      "basisPoints": 10
    }
  }
]

Changes

  • 2f53d445790aRevision changes
    • info

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

  • 42597b350755Revision changes
    • warning

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

    • warning

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

    • warning

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

    • warning

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