Get Contract Status

Retrieves the status of various contract components for a specific node, including burn, fee, listing, rent, and secondary statuses.

Request

GET /v2/admin/node/{node_id}/contract/status

Parameters

Name	Type	In	Description
node_id	string	path	Required. The ID of the node to retrieve contract status for

Headers

Name	Description
Authorization	Required. Bearer token for authentication

Example

curl --request GET \
  --url '\{\{baseUrl\}\}/v2/admin/node/67d6bc4c79cbf60512347a29/contract/status' \
  --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...' \

Response

{
  "data": {
    "burn": {
      "status": 2,
      "error": null
    },
    "fee": {
      "status": 3,
      "error": null
    },
    "listing": {
      "status": 3,
      "error": null
    },
    "rent": {
      "status": 3,
      "error": null
    },
    "secondary": {
      "status": 3,
      "error": null
    }
  }
}

Response Fields

Field	Type	Description
data.burn.status	number	Status code for the burn contract component
data.burn.error	string	Error message for burn component (null if no error)
data.fee.status	number	Status code for the fee contract component
data.fee.error	string	Error message for fee component (null if no error)
data.listing.status	number	Status code for the listing contract component
data.listing.error	string	Error message for listing component (null if no error)
data.rent.status	number	Status code for the rent contract component
data.rent.error	string	Error message for rent component (null if no error)
data.secondary.status	number	Status code for the secondary contract component
data.secondary.error	string	Error message for secondary component (null if no error)

Status Codes

Status Code	Description
200	Success
401	Unauthorized - Invalid or missing authentication token
404	Not Found - Node ID does not exist
500	Internal Server Error

Contract Status Values

Status Value	Description
1 (Started)	The transaction has been created
2 (InProgress)	The transaction is being processed by the relevant unit
3 (Done)	The transaction has been successfully completed
4 (Error)	The transaction has failed to complete