List state changes

Retrieve a paginated list of state changes for a specific smart object. This endpoint provides access to the complete history of state modifications including action types, wallet interactions, nonce values, and state root transitions. State changes can be filtered by various criteria including wallet ID, action ID, change type, and temporal ranges.

GET
/objects/{objectId}/state-changes

Authorization

AuthorizationBearer <token>

In: header

Path Parameters

objectId*string

Query Parameters

id?string

Filter resources by their unique identifier

org_id?string

Filter resources by the organization they belong to

autocomplete?string

Search term for autocomplete functionality

limit?integer

How many items to return at one time (max 100)

Formatint64
next?string

Pagination token for retrieving the next page of results

order?string

Sort order for the results (ascending or descending)

Value in"asc" | "desc"
sortBy?string

Field name to sort the results by

wallet_id?string
action_id?string
batch_id?string
change_type?string
action_type?string
nonce[$gt]?integer
nonce[$lt]?integer
prev_state_root?string
next_state_root?string
when_created[$gt]?string
Formatdate-time
when_created[$lt]?string
Formatdate-time
when_created[$gte]?string
Formatdate-time
when_created[$lte]?string
Formatdate-time

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://api-testnet.dual.network/objects/string/state-changes"
{
  "state_changes": [
    {
      "id": "string",
      "wallet_id": "string",
      "object_id": "string",
      "action_id": "string",
      "action_name": "string",
      "change_type": "create",
      "prev_state_hash": "string",
      "next_state_hash": "string",
      "prev_integrity_hash": "string",
      "next_integrity_hash": "string",
      "prev_nonce": 0,
      "next_nonce": 0,
      "prev_content_hash": "string",
      "next_content_hash": "string",
      "prev_owner": "string",
      "current_owner": "string",
      "merkle_proof": [
        "string"
      ],
      "batch_id": "string",
      "l1_tx_hash": "string",
      "when_created": "2019-08-24T14:15:22Z"
    }
  ],
  "next": "string"
}
{
  "code": 0,
  "message": "string",
  "details": {}
}
{
  "code": 0,
  "message": "string",
  "details": {}
}
{
  "code": 0,
  "message": "string",
  "details": {}
}