Lium · Schema

ExecutorDetailResponse

GPUMarketplaceArtificial IntelligenceComputeCloud

Properties

Name Type Description
id string
machine_name object
price_per_gpu object
pending_price_per_hour object
price_change_effective_date object
validator_hotkey string
gpu_count object
available_gpu_count object
specs object
active object
is_responsive object
uptime_in_minutes object
miner_hotkey object
location object
is_slow_machine boolean
effective_upload_speed_mbps object
effective_download_speed_mbps object
interconnect object How the GPUs are wired to each other, from the validator's nvidia-smi topo run: nvlink/p2p verdicts, pair counts, PCIe class and the GPU x GPU matrix. null = no scrape has reported it for this host ye
tier object
offers_bare_metal boolean The node's provider offers bare-metal rentals (POST /pods/{id}/bare-metal on a whole-node pod).
last_verified_at object When the validator last passed this node: the newest positive validation report the backend received about it, UTC. The validator re-checks a listed node about every 15 minutes, so an older time means
reliability_score object
node_reliability_pct object This node's own reliability score, 0-100. null when no score is available, including while the node is new.
node_reliability_new boolean true while the node is new and has no reliability score yet.
provider_spot_avg_uptime_hours object Spot nodes only: average hours this provider's Spot nodes stayed up before going down, over the last 7 days, the same for every Spot node of one provider. null = under 24 h of Spot history.
frequent_rent_failures boolean true when, in the last 7 days, at least 2 rents on this node failed to start for the host's reasons and they are at least 30% of its rents; the nodes `reliable_only=true` hides. Judged per node.
provider_rating object
provider_notes array Notes the provider shows renters on this node, each from a fixed list (for example "May reboot occasionally"). Empty = none.
provider_key object
gpu_power_limited object true when a GPU on this node runs under 95 % of its default power limit, so a rental gets less than the card's stock power; false when every GPU that reports a default is at it. null = cannot be judge
gpu_power_limit_w object Power limit in watts of the most reduced GPU (the host's own limit while Pearl's cap is live, when reported); null when gpu_power_limited is null.
gpu_power_limit_default_w object That GPU's default power limit in watts; null when gpu_power_limited is null.
distance_mile object
is_bookmarked boolean
min_gpu_count_for_rental object The fewest GPUs a rent of this node accepts as `gpu_count`. Null: the node rents whole only.
min_gpu_count_for_ssh_only_rental object The same for a rent with `enable_jupyter: false`, which needs one free port fewer.
max_cuda_version object
is_whole_host_free object
has_no_pending_rental object
infiniband_fabric_rentable boolean
roce_fabric_rentable boolean
efa_fabric_rentable boolean
operated_by_lium boolean
provider_display_name object
scheduled_notice object
removal_at object
ncu_profiling_enabled boolean
disk_health_ok object Whether the node's docker root takes writes (DAH-2929). True: no read-only mount over the docker root and the write probe did not fail. False: one of those; the readings behind it are in `specs.disk_h
on_infiniband_fabric boolean
on_roce_fabric boolean
on_efa_fabric boolean
nvlink object true when the validator saw every GPU pair joined by NVLink and confirmed it: P2P reads OK on every pair, every GPU has its NVLinks up and the topology covers every GPU. false when a pair is not on NV
gpu_class object The GPU type this node is listed under: the canonical model name of the type, a value `machine_names` accepts and that matches every variant of the type (`NVIDIA B300 SXM6 AC` for a `NVIDIA B300 SXM6
gpu_class_display object The GPU type's name for a filter or a list (`NVIDIA B300 SXM6`); the exact model stays in `machine_name`. Equal to `machine_name` for a type with one model name; null without one.
View JSON Schema on GitHub

JSON Schema

lium-io-executor-detail-response-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/lium-io/json-schema/lium-io-executor-detail-response-schema.json",
  "title": "ExecutorDetailResponse",
  "x-generated": "2026-11-17",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/lium-io-openapi.json#/components/schemas/ExecutorDetailResponse",
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid",
      "title": "Id"
    },
    "machine_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Machine Name"
    },
    "price_per_gpu": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Price Per Gpu"
    },
    "pending_price_per_hour": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Pending Price Per Hour"
    },
    "price_change_effective_date": {
      "anyOf": [
        {
          "type": "string",
          "format": "date-time"
        },
        {
          "type": "null"
        }
      ],
      "title": "Price Change Effective Date"
    },
    "validator_hotkey": {
      "type": "string",
      "title": "Validator Hotkey"
    },
    "gpu_count": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Gpu Count"
    },
    "available_gpu_count": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Available Gpu Count"
    },
    "specs": {
      "additionalProperties": true,
      "type": "object",
      "title": "Specs"
    },
    "active": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "title": "Active"
    },
    "is_responsive": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "title": "Is Responsive"
    },
    "uptime_in_minutes": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Uptime In Minutes"
    },
    "miner_hotkey": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Miner Hotkey"
    },
    "location": {
      "anyOf": [
        {
          "$ref": "#/$defs/LocationResponseForExecutor"
        },
        {
          "type": "null"
        }
      ]
    },
    "is_slow_machine": {
      "type": "boolean",
      "title": "Is Slow Machine",
      "default": false
    },
    "effective_upload_speed_mbps": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Effective Upload Speed Mbps"
    },
    "effective_download_speed_mbps": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Effective Download Speed Mbps"
    },
    "interconnect": {
      "anyOf": [
        {
          "$ref": "#/$defs/InterconnectSpec"
        },
        {
          "type": "null"
        }
      ],
      "description": "How the GPUs are wired to each other, from the validator's nvidia-smi topo run: nvlink/p2p verdicts, pair counts, PCIe class and the GPU x GPU matrix. null = no scrape has reported it for this host yet. A key the validator wrote in a shape the API cannot type is null on its own; the other keys stay. interconnect.nvlink is the topo -m reading alone; the top-level nvlink is that reading confirmed by the other tables."
    },
    "tier": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Tier",
      "default": "secure"
    },
    "offers_bare_metal": {
      "type": "boolean",
      "title": "Offers Bare Metal",
      "description": "The node's provider offers bare-metal rentals (POST /pods/{id}/bare-metal on a whole-node pod).",
      "default": false
    },
    "last_verified_at": {
      "anyOf": [
        {
          "type": "string",
          "format": "date-time"
        },
        {
          "type": "null"
        }
      ],
      "title": "Last Verified At",
      "description": "When the validator last passed this node: the newest positive validation report the backend received about it, UTC. The validator re-checks a listed node about every 15 minutes, so an older time means its recent checks failed or did not arrive. null = no passed check recorded yet."
    },
    "reliability_score": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Reliability Score"
    },
    "node_reliability_pct": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Node Reliability Pct",
      "description": "This node's own reliability score, 0-100. null when no score is available, including while the node is new."
    },
    "node_reliability_new": {
      "type": "boolean",
      "title": "Node Reliability New",
      "description": "true while the node is new and has no reliability score yet.",
      "default": false
    },
    "provider_spot_avg_uptime_hours": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Provider Spot Avg Uptime Hours",
      "description": "Spot nodes only: average hours this provider's Spot nodes stayed up before going down, over the last 7 days, the same for every Spot node of one provider. null = under 24 h of Spot history."
    },
    "frequent_rent_failures": {
      "type": "boolean",
      "title": "Frequent Rent Failures",
      "description": "true when, in the last 7 days, at least 2 rents on this node failed to start for the host's reasons and they are at least 30% of its rents; the nodes `reliable_only=true` hides. Judged per node.",
      "default": false
    },
    "provider_rating": {
      "anyOf": [
        {
          "$ref": "#/$defs/ProviderRating"
        },
        {
          "type": "null"
        }
      ]
    },
    "provider_notes": {
      "items": {
        "type": "string"
      },
      "type": "array",
      "title": "Provider Notes",
      "description": "Notes the provider shows renters on this node, each from a fixed list (for example \"May reboot occasionally\"). Empty = none."
    },
    "provider_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Provider Key"
    },
    "gpu_power_limited": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "title": "Gpu Power Limited",
      "description": "true when a GPU on this node runs under 95 % of its default power limit, so a rental gets less than the card's stock power; false when every GPU that reports a default is at it. null = cannot be judged: no GPU reports both limits, or every GPU that reports sits at Pearl's own temporary cap (70 % of the default) or at the card's driver minimum, which Pearl's cap clamps to on cards whose minimum is above 70 % (RTX 4090, RTX 5090). Such a reading counts as Pearl's while a Lium default-job container is on the node, and also without one when it is under 80 % of the default, since the cap outlives the container; so a host limit at that minimum is not judged in those two cases. A host limit between the minimum and the default is. While Pearl's cap is on and the validator reports the host's own limit under it, that host limit (what the rental gets once Pearl stops) is judged instead."
    },
    "gpu_power_limit_w": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Gpu Power Limit W",
      "description": "Power limit in watts of the most reduced GPU (the host's own limit while Pearl's cap is live, when reported); null when gpu_power_limited is null."
    },
    "gpu_power_limit_default_w": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Gpu Power Limit Default W",
      "description": "That GPU's default power limit in watts; null when gpu_power_limited is null."
    },
    "distance_mile": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Distance Mile"
    },
    "is_bookmarked": {
      "type": "boolean",
      "title": "Is Bookmarked",
      "default": false
    },
    "min_gpu_count_for_rental": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Min Gpu Count For Rental",
      "description": "The fewest GPUs a rent of this node accepts as `gpu_count`. Null: the node rents whole only."
    },
    "min_gpu_count_for_ssh_only_rental": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Min Gpu Count For Ssh Only Rental",
      "description": "The same for a rent with `enable_jupyter: false`, which needs one free port fewer."
    },
    "max_cuda_version": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Max Cuda Version"
    },
    "is_whole_host_free": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "title": "Is Whole Host Free"
    },
    "has_no_pending_rental": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "title": "Has No Pending Rental"
    },
    "infiniband_fabric_rentable": {
      "type": "boolean",
      "title": "Infiniband Fabric Rentable",
      "default": false
    },
    "roce_fabric_rentable": {
      "type": "boolean",
      "title": "Roce Fabric Rentable",
      "default": false
    },
    "efa_fabric_rentable": {
      "type": "boolean",
      "title": "Efa Fabric Rentable",
      "default": false
    },
    "operated_by_lium": {
      "type": "boolean",
      "title": "Operated By Lium",
      "default": false
    },
    "provider_display_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Provider Display Name"
    },
    "scheduled_notice": {
      "anyOf": [
        {
          "$ref": "#/$defs/ScheduledNoticeResponse"
        },
        {
          "type": "null"
        }
      ]
    },
    "removal_at": {
      "anyOf": [
        {
          "type": "string",
          "format": "date-time"
        },
        {
          "type": "null"
        }
      ],
      "title": "Removal At"
    },
    "ncu_profiling_enabled": {
      "type": "boolean",
      "title": "Ncu Profiling Enabled",
      "readOnly": true
    },
    "disk_health_ok": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "title": "Disk Health Ok",
      "description": "Whether the node's docker root takes writes (DAH-2929). True: no read-only mount over the\ndocker root and the write probe did not fail. False: one of those; the readings behind it are\nin `specs.disk_health`. null: the validator has not probed this node this cycle.",
      "readOnly": true
    },
    "on_infiniband_fabric": {
      "type": "boolean",
      "title": "On Infiniband Fabric",
      "readOnly": true
    },
    "on_roce_fabric": {
      "type": "boolean",
      "title": "On Roce Fabric",
      "readOnly": true
    },
    "on_efa_fabric": {
      "type": "boolean",
      "title": "On Efa Fabric",
      "readOnly": true
    },
    "nvlink": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "title": "Nvlink",
      "description": "true when the validator saw every GPU pair joined by NVLink and confirmed it: P2P reads OK on every pair, every GPU has its NVLinks up and the topology covers every GPU. false when a pair is not on NVLink or a check contradicts it; null when the topology is unreported or unconfirmed, or the node has one GPU.",
      "readOnly": true
    },
    "gpu_class": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Gpu Class",
      "description": "The GPU type this node is listed under: the canonical model name of the type, a value `machine_names` accepts and that matches every variant of the type (`NVIDIA B300 SXM6 AC` for a `NVIDIA B300 SXM6 PC` node). Equal to `machine_name` for a type with one model name; null without one.",
      "readOnly": true
    },
    "gpu_class_display": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Gpu Class Display",
      "description": "The GPU type's name for a filter or a list (`NVIDIA B300 SXM6`); the exact model stays in `machine_name`. Equal to `machine_name` for a type with one model name; null without one.",
      "readOnly": true
    }
  },
  "type": "object",
  "required": [
    "id",
    "validator_hotkey",
    "specs",
    "ncu_profiling_enabled",
    "disk_health_ok",
    "on_infiniband_fabric",
    "on_roce_fabric",
    "on_efa_fabric",
    "nvlink",
    "gpu_class",
    "gpu_class_display"
  ],
  "$defs": {
    "InterconnectSpec": {
      "properties": {
        "gpu_count": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Gpu Count"
        },
        "gpu_pairs": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Gpu Pairs"
        },
        "nvlink": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "title": "Nvlink"
        },
        "nvlink_links": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Nvlink Links"
        },
        "nvlink_pairs": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Nvlink Pairs"
        },
        "nvlink_active_links": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Nvlink Active Links"
        },
        "pcie_class": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Pcie Class"
        },
        "p2p": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "title": "P2P"
        },
        "p2p_pairs": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "P2P Pairs"
        },
        "p2p_ok_pairs": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "P2P Ok Pairs"
        },
        "matrix": {
          "anyOf": [
            {
              "items": {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "title": "Matrix"
        }
      },
      "type": "object",
      "title": "InterconnectSpec",
      "description": "How the GPUs of one host are wired to each other, from the validator's `nvidia-smi topo` run.\n\nScraped by lium-io DAH-2922, declared and exposed here (DAH-2923).\n`nvlink` is True only when EVERY GPU pair is joined by NVLink (an HGX board); a box with NVLink\nbridges on some pairs reports False with `nvlink_pairs` < `gpu_pairs`. `p2p` is True only when\nevery pair of `nvidia-smi topo -p2p r` reads OK — False is the host where NCCL cannot start\nwithout NCCL_P2P_DISABLE=1. Both are None on a single-GPU host (nothing to judge) and when the\ntable that answers them could not be read (`interconnect_scrape_error` on MachineSpecs says why).\n`pcie_class` is nvidia-smi's worst class among the non-NVLink pairs (SYS > NODE > PHB > PXB > PIX).\n`matrix` is the GPU x GPU cell table, kept so a client can print the topology."
    },
    "LocationResponseForExecutor": {
      "properties": {
        "id": {
          "type": "string",
          "format": "uuid",
          "title": "Id"
        },
        "created_at": {
          "type": "string",
          "format": "date-time",
          "title": "Created At"
        },
        "updated_at": {
          "anyOf": [
            {
              "type": "string",
              "format": "date-time"
            },
            {
              "type": "null"
            }
          ],
          "title": "Updated At"
        },
        "country": {
          "type": "string",
          "title": "Country"
        },
        "country_code": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Country Code"
        },
        "region": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Region"
        },
        "region_name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Region Name"
        },
        "city": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "City"
        },
        "zip": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Zip"
        },
        "lat": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Lat"
        },
        "lon": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Lon"
        },
        "timezone": {
          "type": "string",
          "title": "Timezone"
        },
        "source": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Source"
        }
      },
      "type": "object",
      "required": [
        "country",
        "timezone"
      ],
      "title": "LocationResponseForExecutor"
    },
    "ProviderRating": {
      "properties": {
        "average": {
          "type": "number",
          "title": "Average",
          "description": "Average 1-5 star rating, one decimal."
        },
        "count": {
          "type": "integer",
          "title": "Count",
          "description": "How many ratings the average is over."
        }
      },
      "type": "object",
      "required": [
        "average",
        "count"
      ],
      "title": "ProviderRating"
    },
    "ScheduledNoticeResponse": {
      "properties": {
        "starting_at": {
          "type": "string",
          "format": "date-time",
          "title": "Starting At"
        },
        "expiring_at": {
          "type": "string",
          "format": "date-time",
          "title": "Expiring At"
        },
        "permanent_removal": {
          "type": "boolean",
          "title": "Permanent Removal",
          "default": false
        }
      },
      "type": "object",
      "required": [
        "starting_at",
        "expiring_at"
      ],
      "title": "ScheduledNoticeResponse",
      "description": "A provider's open maintenance or removal notice on a listed node, shown before the renter rents it.\n\nWhen `expiring_at` passes, `handle_notice_period` reboots a pod on the node (maintenance) or deletes it\n(`permanent_removal`), so a rental taken now is interrupted then. The provider's free-text reason is left out."
    }
  }
}

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.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/lium-io-executor-detail-response"
All schemas
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.