{
  "$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."
    }
  }
}