Ctrl+K

List Token Contract Modification Requests

get/api/stablecoin/v1/issuer/token-contract-modification-requests

Returns a paginated list of token contract modification requests (e.g. blacklist / freeze)

Query Parameters

  • statusstring
    Filter by request status
    Example: pending
    Enum: pending approved confirmed rejected failed
  • typestring
    Filter by request type
    Example: blacklist
    Enum: blacklist unblacklist freeze unfreeze
  • addressstring
    Filter by blockchain address
    Example: 0xd0898d88e2c08b2a95e19441e412c0a708a8bd43
    Min length: >= 1 characters
  • assetIdstring<uuid>
    Filter by asset identifier
    Example: 0438163a-d236-4865-978e-02ee7c2285b7
  • baseAssetstring
    Filter by base asset
    Example: usd1
    Enum: gousd usd1 sofid cusd fyusd usd
  • chainstring
    Filter by blockchain network
    Example: eth
    Min length: >= 1 characters
  • pagestring<number>
    Page number (1-based)
    Example: 1
  • pageSizestring<number>
    Number of results per page
    Example: 20

200 Response

requests array[object] required
Paginated list of token contract modification requests
id string <uuid>required
Unique identifier
Min length: >= 1 characters
Example: 177dc9ed-64a7-4f68-9ba5-8d5b55fe5878
address string required
Address targeted by this request
Min length: >= 1 characters
Example: 0xd0898d88e2c08b2a95e19441e412c0a708a8bd43
type string required
Type of token contract operation
Allowed values: blacklist unblacklist freeze unfreeze
Example: blacklist
status string required
Current lifecycle status of the request
Allowed values: pending approved confirmed rejected failed
Example: pending
userId string required
User ID of the requester
Min length: >= 1 characters
Example: 6437d9f07d6a87000613e6c06e4218d3
assetId string <uuid>required
Asset id
Example: 0438163a-d236-4865-978e-02ee7c2285b7
baseAsset string required
Base asset type
Allowed values: gousd usd1 sofid cusd fyusd usd
Example: usd1
chain string required
Blockchain network identifier
Min length: >= 1 characters
Example: eth
createdAt string <date-time>required
Timestamp when the request was created
Example: 2026-03-24T12:00:00.000Z
transactionHash string
Min length: >= 1 characters
confirmedAt string <date-time>
comments string
Min length: >= 1 characters
approverId string
Min length: >= 1 characters
rejectorId string
Min length: >= 1 characters
total number required
Total number of matching requests across all pages

400 Response

401 Response

500 Response