Get Change Owner Process

Returns one node ownership change process with its steps. Poll it after starting a process: it reports which step is running, each step's transaction hash once confirmed, and the error of a failed step. Any API key whose node is the node in the path or one of its ancestors may read it.

Required permission: node:change-owner

Request

GET /v2/admin/nodes/{node_id}/change-owner-processes/{process_id}

Parameters

Name	Type	In	Description
node_id	string	path	Required. The node that owns the setup
process_id	string	path	Required. The process id; must belong to node_id

Headers

Name	Description
Authorization	Required. Bearer <access_token>

Example

curl --request GET \
  --url '{{baseUrl}}/v2/admin/nodes/6901350deb7ed8c1c38de4e9/change-owner-processes/6907a4e1b5c83f2d9e6a0b17' \
  --header 'Authorization: Bearer <access_token>'

Response

A process paused on a failed step:

{
  "id": "6907a4e1b5c83f2d9e6a0b17",
  "node_id": "6901350deb7ed8c1c38de4e9",
  "setup_id": "6905f1c2a8e4b27d3c9a1f42",
  "network_id": "68fe7b31c2d94a5e8b1f0c63",
  "old_owner_address": "0xecE2c86490b1214035cb1bbcC9781aE45d29BB97",
  "new_wallet_id": "6a89b68e0c46ca4c941271aa",
  "new_owner_address": "0xa112983907944387B64ba512daF256B3f28f93f5",
  "status": "paused",
  "current_step_order": 2,
  "total_steps": 3,
  "progress": 33.33333333333333,
  "steps": [
    {
      "id": "6907a4e1b5c83f2d9e6a0b18",
      "type": "transfer_tokenized_assets",
      "status": "completed",
      "order": 1,
      "token_id": "67d8774e903bfcbe7eb5d93e",
      "transaction_hash": "0x5c504ed432cb51138bcf09aa5e8a410dd4a1e204ef84bfed1be16dfba1b22060",
      "retry_count": 0,
      "max_retries": 3,
      "error": null,
      "started_at": "2026-11-02T09:14:28.104Z",
      "completed_at": "2026-11-02T09:15:02.871Z"
    },
    {
      "id": "6907a4e1b5c83f2d9e6a0b19",
      "type": "transfer_tokenized_assets",
      "status": "failed",
      "order": 2,
      "token_id": "67e1a2b3c4d5e6f708192a3b",
      "transaction_hash": null,
      "retry_count": 0,
      "max_retries": 3,
      "error": "execution reverted",
      "started_at": "2026-11-02T09:15:03.220Z",
      "completed_at": null
    },
    {
      "id": "6907a4e1b5c83f2d9e6a0b1a",
      "type": "change_node_owner",
      "status": "pending",
      "order": 3,
      "token_id": null,
      "transaction_hash": null,
      "retry_count": 0,
      "max_retries": 3,
      "error": null,
      "started_at": null,
      "completed_at": null
    }
  ],
  "error": null,
  "created_at": "2026-11-02T09:14:27.512Z",
  "updated_at": "2026-11-02T09:15:19.448Z",
  "completed_at": null
}

Response Fields

Field	Type	Description
id	string	Process id
node_id	string	The node that owns the setup
setup_id	string	The setup the change runs on
network_id	string	The setup's network
old_owner_address	string	Address of the setup's owner wallet when the process started
new_wallet_id	string	The wallet selected as new owner
new_owner_address	string	Address of the new owner wallet
status	string	Process status: started, in_progress, paused, completed, failed, cancelled. See the overview.
current_step_order	integer	order of the step being executed; 0 before the first step is sent
total_steps	integer	Number of steps: one per tokenized asset plus the final owner change
progress	number	Percentage (0–100) of steps that are completed or skipped
steps	array	The steps, in order
steps[].id	string	Step id
steps[].type	string	transfer_tokenized_assets (moves one token) or change_node_owner (changes the diamond owner; always last)
steps[].status	string	pending, in_progress, completed, failed, skipped
steps[].order	integer	Position of the step, starting at 1. Pass it as step_order to retry.
steps[].token_id	string | null	The token a transfer step moves; null for change_node_owner
steps[].transaction_hash	string | null	Hash of the confirmed transaction
steps[].retry_count	integer	How many times the step was retried
steps[].max_retries	integer	Retry limit of the step (3)
steps[].error	string | null	Why the step failed
steps[].started_at	string | null	When the step was sent
steps[].completed_at	string | null	When the step completed
error	string | null	Process-level error. Step failures are reported on the step.
created_at	string	ISO 8601 creation time
updated_at	string	ISO 8601 time of the last change
completed_at	string | null	When the process completed

Errors

Status	Code	Description
400	10016	node_id is not a valid id
400	10000	process_id is not a valid id
400	10001	Node not found
400	20001	No process with this id on this node
403	10005	The node is outside the API key's node hierarchy

See Errors for the error format and common codes.