Stablecoin

List issuer stablecoin orders

Changed on

Fetches orders for all stablecoin assets issued by the authenticated enterprise (e.g., GoUSD, SoFiD, USD1). Returns an object containing an orders array of mixed order responses.

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

Request

  • Base URL
    https://developers.bitgo.com
  • URL
    https://developers.bitgo.com/api/stablecoin/v1/enterprise/{enterpriseId}/issuer/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

'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' | 'pending' | 'pendingApproval'
OR
string[]

Order processing status — accepts both user-facing (created, pending, fulfilled) and internal statuses

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

tokenstring
Example:eth:usd1

Token identifier to filter orders

chainstring
Example:eth

Blockchain network identifier

string
OR
string[]

Enterprise ID(s) of the client enterprise(s) that placed the orders

Response

OK

Example response

{
  "orders": [
    {
      "asset": "eth:usd1",
      "destinationWalletId": "8iMXoeSpS1d1ziEJ",
      "destinationAddress": "d526909b2398a6d579c817dc07fc9d72",
      "userId": "test-user",
      "transactions": [
        {
          "type": "clientDeposit",
          "txHash": "512f64d10b5f358f6dbf3303f90013cfa46006b02a03282456d6bd6432cc5daf",
          "asset": "eth:usd1",
          "amount": "500",
          "status": "confirmed",
          "createdAt": "2025-04-04T09:26:21.600Z",
          "updatedAt": "2025-04-04T09:26:21.600Z"
        }
      ],
      "memo": "Payment for invoice #1234",
      "pendingApprovalId": "677cfdceca8396cf5f7534ddeb8d11e3",
      "createdAt": "2025-04-04T09:25:48.216Z",
      "updatedAt": "2025-04-04T09:55:09.136Z",
      "fromAssetId": "08c1271e-b15d-4af8-8929-f75383903da4",
      "toAssetId": "49ff49ea-3355-4717-bbb0-5e8f5cae2202",
      "fromAsset": "eth:usd1",
      "fromAmount": "500",
      "toAsset": "eth:usd1",
      "toAmount": "5000000",
      "orderMethod": "issuer_direct",
      "id": "95bdbd9c-9cdc-41a4-ae70-165387b7aa51",
      "type": "mint",
      "status": "fulfilled",
      "enterpriseId": "67bc4ae090e8af8f9b412d3d67e85252"
    }
  ]
}

Changes

  • a65d533e96a4Revision 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 policy_rejected enum value to the ///// response property for the response status

    • info

      added the enum value pendingApproval to the property oneOf[subschema #1: IssuerOrderStatusFilter]/ of the query request parameter status

    • info

      added the enum value pendingApproval to the property oneOf[subschema #2]/items/ of the query request parameter status

    • info

      added the enum value pending_policy_approval to the property oneOf[subschema #1: IssuerOrderStatusFilter]/ of the query request parameter status

    • info

      added the enum value pending_policy_approval to the property oneOf[subschema #2]/items/ of the query request parameter status

    • info

      added the enum value policy_rejected to the property oneOf[subschema #1: IssuerOrderStatusFilter]/ of the query request parameter status

    • info

      added the enum value policy_rejected to the property oneOf[subschema #2]/items/ of the query request parameter status