Stablecoin

List Compliance Requests (Issuer)

Changed on

Returns a paginated list of compliance requests for the authenticated issuer's assets. List rows omit complianceRequestHistory — use the get-by-id endpoint for the full audit trail.

get/api/stablecoin/v1/issuer/compliance-requests

Request

  • Base URL
    https://developers.bitgo.com
  • URL
    https://developers.bitgo.com/api/stablecoin/v1/issuer/compliance-requests
  • Auth
    none declared

Query parameters

'created' | 'pending_approval' | 'approved' | 'confirmed' | 'rejected' | 'cancelled' | 'failed'
OR
string[]

Filter by one or more lifecycle statuses

'created' | 'pending_approval' | 'approved' | 'confirmed' | 'rejected' | 'cancelled' | 'failed'
OR
string[]

Sort requests matching one or more statuses to the top of the results, ahead of the rest (which remain sorted by date)

type'freeze' | 'unfreeze' | 'pause' | 'unpause'
Example:freeze

Filter by compliance operation type

tokenstring
Example:eth:gousd

Filter by token identifier (chain:baseAsset, e.g. eth:gousd)

assetIdstring uuid
Example:0438163a-d236-4865-978e-02ee7c2285b7

Filter by asset identifier

baseAsset'gousd' | 'usd1' | 'sofid' | 'cusd' | 'fyusd' | 'qxmp' | 'scaasacme'
Example:usd1

Filter by base stablecoin symbol

chainstring
Example:eth

Filter by blockchain network

addressstring
Example:0xd0898d88e2c08b2a95e19441e412c0a708a8bd43

Filter by targeted blockchain address

enterpriseIdstring
Example:6437d9f07d6a87000613e6c06e4218d3

Filter by enterprise identifier

fromDatestring date-time
Example:2025-01-01T00:00:00.000Z

Include only requests created on or after this timestamp

toDatestring date-time
Example:2025-12-31T23:59:59.999Z

Include only requests created on or before this timestamp

pagestring number
Example:1

1-based page number

pageSizestring number
Example:25

Number of results per page (1–100)

Response

OK

totalnumber required

Total number of matching requests across all pages

Example response

{
  "requests": [
    {
      "id": "177dc9ed-64a7-4f68-9ba5-8d5b55fe5878",
      "type": "freeze",
      "status": "pending_approval",
      "assetId": "0438163a-d236-4865-978e-02ee7c2285b7",
      "requestSource": "issuer",
      "baseAsset": "usd1",
      "chain": "eth",
      "address": "0xd0898d88e2c08b2a95e19441e412c0a708a8bd43",
      "addressLabel": "Hot Wallet A",
      "createdAt": "2025-06-23T07:28:17.042Z",
      "updatedAt": "2025-06-23T07:28:17.042Z",
      "enterpriseId": "6437d9f07d6a87000613e6c06e4218d3",
      "userId": "6437d9f07d6a87000613e6c06e4218d3",
      "comments": "Suspicious activity detected",
      "pendingApprovalId": "pa_123",
      "bitgoTransferId": "6437d9f07d6a87000613e6c06e4218d3",
      "transactionHash": "0xabcdef1234567890"
    }
  ]
}

Changes

  • a7126d55243dRevision changes
    • breaking

      the response property // became optional for the status

  • 70b5f74b1799Revision changes
    • warning

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

    • warning

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

    • info

      added the new enum value pause to the query request parameter type

    • info

      added the new enum value unpause to the query request parameter type