NodeListingResponse
`GET /executors/listing`: one of the caller's own nodes against the public listing.
Properties
| Name | Type | Description |
|---|---|---|
| id | string | |
| listing_state | object | |
| hidden_reasons | array | |
| blocking_reasons | array | |
| idle_pay_pending_first_check | boolean | |
| idle_pay_state | object | |
| secure_listing_requires_idle_pay | boolean | |
| gpu_count | integer | |
| rented_gpu_count | integer | |
| rented_since | object | |
| last_rental_ended_at | object | |
| computed_status | object | |
| new_rentals_pause_requested_at | object | |
| pause_id | object |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/lium-io/json-schema/lium-io-node-listing-response-schema.json",
"title": "NodeListingResponse",
"description": "`GET /executors/listing`: one of the caller's own nodes against the public listing.",
"x-generated": "2026-11-17",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/provider-api-lium-io-openapi.json#/components/schemas/NodeListingResponse",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"title": "Id"
},
"listing_state": {
"$ref": "#/$defs/ListingState"
},
"hidden_reasons": {
"items": {
"$ref": "#/$defs/ListingHiddenReason"
},
"type": "array",
"title": "Hidden Reasons",
"default": []
},
"blocking_reasons": {
"items": {
"$ref": "#/$defs/BlockingReason"
},
"type": "array",
"title": "Blocking Reasons",
"default": []
},
"idle_pay_pending_first_check": {
"type": "boolean",
"title": "Idle Pay Pending First Check",
"default": false
},
"idle_pay_state": {
"anyOf": [
{
"type": "string",
"enum": [
"paid",
"not_paid",
"rented_last_cycle",
"unknown",
"pending_first_check"
]
},
{
"type": "null"
}
],
"title": "Idle Pay State"
},
"secure_listing_requires_idle_pay": {
"type": "boolean",
"title": "Secure Listing Requires Idle Pay",
"default": false
},
"gpu_count": {
"type": "integer",
"title": "Gpu Count",
"default": 0
},
"rented_gpu_count": {
"type": "integer",
"title": "Rented Gpu Count",
"default": 0
},
"rented_since": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Rented Since"
},
"last_rental_ended_at": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Last Rental Ended At"
},
"computed_status": {
"anyOf": [
{
"$ref": "#/$defs/ExecutorComputedStatus"
},
{
"type": "null"
}
]
},
"new_rentals_pause_requested_at": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "New Rentals Pause Requested At"
},
"pause_id": {
"anyOf": [
{
"type": "string",
"format": "uuid"
},
{
"type": "null"
}
],
"title": "Pause Id"
}
},
"type": "object",
"required": [
"id",
"listing_state"
],
"$defs": {
"BlockingReason": {
"properties": {
"kind": {
"$ref": "#/$defs/BlockingReasonKind"
},
"code": {
"type": "string",
"title": "Code"
},
"title": {
"type": "string",
"title": "Title"
},
"message": {
"type": "string",
"title": "Message"
},
"measured": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Measured"
},
"required": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Required"
},
"fix": {
"type": "string",
"title": "Fix"
},
"fix_command": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Fix Command"
},
"verify_command": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Verify Command"
},
"requires": {
"items": {
"$ref": "#/$defs/FixRequirement"
},
"type": "array",
"title": "Requires",
"default": []
},
"docs_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Docs Url"
},
"gating": {
"type": "boolean",
"title": "Gating",
"default": false
},
"secure_requirement": {
"type": "boolean",
"title": "Secure Requirement",
"default": false
}
},
"type": "object",
"required": [
"kind",
"code",
"title",
"message",
"fix"
],
"title": "BlockingReason",
"description": "One thing that keeps the node from earning or from being rented, and the exact fix.\n\nThe dashboard and the CLI print this list as it is (services/blocking_reasons.py), so the\nwording lives in one place. `measured` against `required` is empty where the check has no value."
},
"BlockingReasonKind": {
"type": "string",
"enum": [
"idle_pay",
"availability",
"last_error",
"listing",
"advisory"
],
"title": "BlockingReasonKind",
"description": "Where a blocking reason comes from."
},
"ComputedStatus": {
"type": "string",
"enum": [
"OFFLINE",
"RECLAIMING",
"VALIDATION_PENDING",
"VALIDATION_FAILED",
"NOT_DETECTED",
"AVAILABLE",
"RENTED",
"PAUSING_NEW_RENTALS",
"NEW_RENTALS_PAUSED"
],
"title": "ComputedStatus"
},
"ExecutorComputedStatus": {
"properties": {
"status": {
"$ref": "#/$defs/ComputedStatus"
},
"message": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Message"
},
"last_error": {
"anyOf": [
{
"$ref": "#/$defs/ExecutorLastError"
},
{
"type": "null"
}
]
},
"last_warning": {
"anyOf": [
{
"$ref": "#/$defs/ExecutorLastError"
},
{
"type": "null"
}
]
},
"last_successful_validation": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Last Successful Validation"
},
"offline_since": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Offline Since"
},
"last_check_at": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Last Check At"
}
},
"type": "object",
"required": [
"status"
],
"title": "ExecutorComputedStatus"
},
"ExecutorLastError": {
"properties": {
"title": {
"type": "string",
"title": "Title"
},
"message": {
"type": "string",
"title": "Message"
},
"time": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Time"
},
"source": {
"type": "string",
"enum": [
"Validator",
"Pinger",
"Platform"
],
"title": "Source"
},
"reason_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Reason Code"
},
"impact": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Impact"
},
"remediation": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Remediation"
},
"what_we_saw": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"title": "What We Saw"
},
"failed_step": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Failed Step"
},
"help_uri": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Help Uri"
}
},
"type": "object",
"required": [
"title",
"message",
"source"
],
"title": "ExecutorLastError"
},
"FixRequirement": {
"type": "string",
"enum": [
"sudo",
"reboot",
"no_rentals"
],
"title": "FixRequirement",
"description": "What running a blocking reason's fix needs, so an agent knows when to stop and hand over."
},
"ListingHiddenReason": {
"properties": {
"code": {
"type": "string",
"title": "Code"
},
"message": {
"type": "string",
"title": "Message"
}
},
"type": "object",
"required": [
"code",
"message"
],
"title": "ListingHiddenReason",
"description": "One listing gate the node fails now; `code` is stable, `message` is for the provider."
},
"ListingState": {
"type": "string",
"enum": [
"rented",
"listed",
"hidden",
"offline",
"validating"
],
"title": "ListingState",
"description": "Where a node stands against the public listing (`GET /api/executors` and its live feed)."
}
}
}
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
curl "https://apis.io/api/v1/json-schemas/lium-io-node-listing-response"
curl "https://apis.io/api/v1/json-schemas?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.