List operations for an asset

GET

https://your-protect-instance.example.com/api/rest/v2/assets/:assetID/operations

GET

/api/rest/v2/assets/:assetID/operations

curl https://your-protect-instance.example.com/api/rest/v2/assets/assetID/operations \
     -H "Authorization: Bearer <token>"

{
  "result": [
    {
      "id": "string",
      "assetID": "string",
      "type": "ASSET_OPERATION_TYPE_V2_CREATE",
      "status": "ASSET_OPERATION_STATUS_V2_PENDING",
      "createdAt": "2024-01-15T09:30:00Z",
      "updatedAt": "2024-01-15T09:30:00Z",
      "initiatedByAddressID": "string",
      "failureReason": "ASSET_OPERATION_FAILURE_REASON_V2_UNKNOWN",
      "blockingReason": "ASSET_OPERATION_BLOCKING_REASON_V2_UNKNOWN",
      "create": {
        "label": "string",
        "price": "string",
        "decimals": "string",
        "params": {
          "cantonNativeTokenParams": {
            "instrumentID": "string",
            "name": "string",
            "symbol": "string"
          }
        },
        "blockchain": "string",
        "network": "string",
        "assetType": "string"
      },
      "update": {
        "label": "string",
        "price": "string",
        "params": {
          "cantonUpdateNativeTokenParams": {
            "requireCredentials": true
          }
        }
      },
      "import": {
        "blockchain": "string",
        "network": "string",
        "label": "string",
        "price": "string",
        "decimals": "string",
        "address": "string",
        "params": {
          "cantonNativeTokenImportParams": {}
        }
      },
      "mint": {
        "destination": {
          "addressID": "string",
          "whitelistedAddressID": "string"
        },
        "amount": "string",
        "nftMetadata": [
          "string"
        ]
      },
      "burn": {
        "destination": {
          "addressID": "string",
          "whitelistedAddressID": "string"
        },
        "amount": "string",
        "nftTokenIDs": [
          "string"
        ]
      },
      "pause": {},
      "unpause": {},
      "pauseAccount": {
        "target": {
          "addressID": "string",
          "whitelistedAddressID": "string"
        }
      },
      "unpauseAccount": {
        "target": {
          "addressID": "string",
          "whitelistedAddressID": "string"
        }
      },
      "setKyc": {
        "target": {
          "addressID": "string",
          "whitelistedAddressID": "string"
        },
        "status": "KYC_STATUS_V2_APPROVED"
      }
    }
  ],
  "cursor": {
    "currentPage": "string",
    "hasPrevious": true,
    "hasNext": true
  }
}

Returns the history of lifecycle operations for the asset (creation, mints, burns, KYC changes, pause/unpause, …).

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

assetIDstringRequired

Query parameters

cursor.currentPagestringOptional

Base64-encoded string representing the current window of data

cursor.pageRequeststringOptional

The page to request, w.r.t the current page. Can be one of FIRST, PREVIOUS, NEXT, LAST

cursor.pageSizestringOptionalformat: "uint64"

The size of the page requested. The handling service should impose a hard limit on this

typeenumOptional

Optional filter — when set, return only operations of this type.

statusenumOptional

Optional filter — when set, return only operations in this status.

Allowed values:

Response

A successful response.

resultlist of objectsOptional

cursorobjectOptional

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error

503

Service Unavailable Error