REST API›Mint›Stablecoin

GET

List Compliance Requests (Issuer)

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.

Query Params

  • status string or array of strings
    Filter by one or more lifecycle statuses

    ONE OF

    string enum
  • sortStatusFirst string or array of strings
    Sort requests matching one or more statuses to the top of the results, ahead of the rest (which remain sorted by date)

    ONE OF

    string enum
  • type string enum
    Filter by compliance operation type
    freezeunfreeze
  • token string
    Filter by token identifier (chain:baseAsset, e.g. eth:gousd)

    at least 1 characters

  • assetId string uuid
    Filter by asset identifier
  • baseAsset string enum
    Filter by base stablecoin symbol
    gousdusd1sofidcusdfyusdqxmpscaasacme
  • chain string
    Filter by blockchain network

    at least 1 characters

  • address string
    Filter by targeted blockchain address

    at least 1 characters

  • enterpriseId string
    Filter by enterprise identifier

    at least 1 characters

  • fromDate string date-time
    Include only requests created on or after this timestamp
  • toDate string date-time
    Include only requests created on or before this timestamp
  • page string number
    1-based page number
  • pageSize string number
    Number of results per page (1–100)

Responses

200
OK

Response Body

object

  • requests array of objects required
    requests object
    • id string uuid required
      Unique identifier for the compliance request

      at least 1 characters

    • type string enum required
      Type of compliance operation
      freezeunfreeze
    • status string enum required
      Current lifecycle status
      createdpending_approvalapprovedconfirmedrejectedcancelledfailed
    • assetId string uuid required
      ID of the asset this request applies to

      at least 1 characters

    • enterpriseId string required
      Enterprise ID of the requester

      at least 1 characters

    • requestSource string enum required
      Source that originated this compliance request; trust-initiated requests are surfaced as 'bitgo'
      issuerbitgo
    • baseAsset string enum required
      Base stablecoin symbol for the asset
      gousdusd1sofidcusdfyusdqxmpscaasacme
    • chain string required
      Blockchain network for the asset

      at least 1 characters

    • address string required
      Blockchain address targeted by this request

      at least 1 characters

    • addressLabel string required
      Human-readable label for the targeted address

      at least 1 characters

    • createdAt string date-time required
      Timestamp when the request was created
    • updatedAt string date-time required
      Timestamp when the request was last updated
    • userId string
      ID of the user who created the request; omitted when the maker is bitgo-source on issuer-facing responses

      at least 1 characters

    • comments string
      Optional notes about the request

      at least 1 characters

    • pendingApprovalId string
      Platform pending-approval ID, present after the request is submitted for approval

      at least 1 characters

    • bitgoTransferId string
      BitGo transfer ID, present after the transaction is broadcast

      at least 1 characters

    • transactionHash string
      On-chain transaction hash, present after confirmation

      at least 1 characters

  • total number required
    Total number of matching requests across all pages
400
Bad Request
No response body
401
Unauthorized
No response body
403
Forbidden
No response body
500
Internal Server Error
No response body