GET /api/hosts/:id
Show a host

Examples

GET /api/hosts/host4.example1.com?show_hidden_parameters=true
200
{
  "ip": "0.0.0.1",
  "ip6": null,
  "last_report": null,
  "mac": "00:53:67:ab:00:01",
  "realm_id": null,
  "realm_name": null,
  "sp_mac": null,
  "sp_ip": null,
  "sp_name": null,
  "domain_id": 759776764,
  "domain_name": "example1.com",
  "architecture_id": 922134522,
  "architecture_name": "x86_64-1",
  "operatingsystem_id": 1073012829,
  "operatingsystem_name": "operatingsystem1 1",
  "subnet_id": null,
  "subnet_name": null,
  "subnet6_id": null,
  "subnet6_name": null,
  "sp_subnet_id": null,
  "ptable_id": 1007981702,
  "ptable_name": "ptable1",
  "medium_id": 1011586619,
  "medium_name": "medium1",
  "pxe_loader": "Grub2 UEFI",
  "build": false,
  "comment": "",
  "disk": null,
  "initiated_at": null,
  "installed_at": null,
  "model_id": null,
  "hostgroup_id": null,
  "owner_id": 135138680,
  "owner_name": "Admin User",
  "owner_type": "User",
  "creator_id": 135138680,
  "creator": "Admin User",
  "enabled": true,
  "managed": true,
  "use_image": null,
  "image_file": "",
  "uuid": null,
  "compute_resource_id": null,
  "compute_resource_name": null,
  "compute_profile_id": null,
  "compute_profile_name": null,
  "capabilities": [
    "build"
  ],
  "provision_method": "build",
  "certname": "host4.example1.com",
  "image_id": null,
  "image_name": null,
  "created_at": "2025-11-11 20:08:44 UTC",
  "updated_at": "2025-11-11 20:08:44 UTC",
  "last_compile": null,
  "global_status": 0,
  "global_status_label": "OK",
  "global_status_fulltext": [
    "Build: Installed"
  ],
  "bmc_available": false,
  "organization_id": 447626438,
  "organization_name": "Organization 1",
  "location_id": 255093256,
  "location_name": "Location 1",
  "puppet_status": 0,
  "model_name": null,
  "build_status": 0,
  "build_status_label": "Installed",
  "name": "host4.example1.com",
  "id": 4,
  "display_name": "host4.example1.com",
  "puppet_proxy_id": null,
  "puppet_proxy_name": null,
  "puppet_ca_proxy_id": null,
  "puppet_ca_proxy_name": null,
  "puppet_proxy": null,
  "puppet_ca_proxy": null,
  "compute_resource_provider": null,
  "hostgroup_name": null,
  "hostgroup_title": null,
  "parameters": [],
  "all_parameters": [
    {
      "priority": null,
      "created_at": "2025-11-11 20:08:42 UTC",
      "updated_at": "2025-11-11 20:08:42 UTC",
      "id": 513706444,
      "name": "loc_param",
      "parameter_type": "string",
      "associated_type": "location",
      "hidden_value?": false,
      "value": "abc"
    },
    {
      "priority": null,
      "created_at": "2025-11-11 20:08:42 UTC",
      "updated_at": "2025-11-11 20:08:42 UTC",
      "id": 32400255,
      "name": "org_param",
      "parameter_type": "string",
      "associated_type": "organization",
      "hidden_value?": false,
      "value": "xyz"
    },
    {
      "priority": null,
      "created_at": "2025-11-11 20:08:42 UTC",
      "updated_at": "2025-11-11 20:08:42 UTC",
      "id": 636252244,
      "name": "test",
      "parameter_type": "string",
      "associated_type": "global",
      "hidden_value?": false,
      "value": "myvalue"
    }
  ],
  "interfaces": [
    {
      "subnet_id": null,
      "subnet_name": null,
      "subnet6_id": null,
      "subnet6_name": null,
      "domain_id": 759776764,
      "domain_name": "example1.com",
      "host_id": 4,
      "host_name": "host4.example1.com",
      "created_at": "2025-11-11 20:08:44 UTC",
      "updated_at": "2025-11-11 20:08:44 UTC",
      "managed": true,
      "identifier": "eth1",
      "id": 4,
      "name": "host4.example1.com",
      "ip": "0.0.0.1",
      "ip6": null,
      "mac": "00:53:67:ab:00:01",
      "mtu": null,
      "fqdn": "host4.example1.com",
      "primary": true,
      "provision": true,
      "type": "interface",
      "virtual": false
    }
  ],
  "permissions": {
    "view_hosts": true,
    "create_hosts": true,
    "edit_hosts": true,
    "destroy_hosts": true,
    "build_hosts": true,
    "power_hosts": true,
    "console_hosts": true,
    "ipmi_boot_hosts": true
  }
}

Params

Param name Description
location_id
optional

Set the current location context for the request

Validations:

  • Must be a Integer
organization_id
optional

Set the current organization context for the request

Validations:

  • Must be a Integer
id
required

Validations:

  • Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, dot(.), space, underscore(_), hypen(-) with no leading or trailing space.
show_hidden_parameters
optional

Display hidden parameter values

Validations:

  • Must be one of: true, false, 1, 0.