GET /api/hosts
List all hosts

GET /api/hostgroups/:hostgroup_id/hosts
List all hosts for a host group

GET /api/locations/:location_id/hosts
List hosts per location

GET /api/organizations/:organization_id/hosts
List hosts per organization

Examples

GET /api/v2/hosts?thin=true&page=1&per_page=10&search=
200
{
  "total": 2,
  "subtotal": 2,
  "page": 1,
  "per_page": 10,
  "search": "",
  "sort": {
    "by": null,
    "order": null
  },
  "results": [
    {
      "id": 1,
      "name": "host5.example2.com"
    },
    {
      "id": 2,
      "name": "host6"
    }
  ]
}

Params

Param name Description
thin
optional

Only list ID and name of hosts

Validations:

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

ID of host group

Validations:

  • Must be a String
location_id
optional

ID of location

Validations:

  • Must be a String
organization_id
optional

ID of organization

Validations:

  • Must be a String
include
optional

Array of extra information types to include

Validations:

  • Must be one of: parameters, all_parameters.
search
optional

filter results

Validations:

  • Must be a String
order
optional

Sort and order by a searchable field, e.g. '<field> DESC'

Validations:

  • Must be a String
page
optional

Page number, starting at 1

Validations:

  • Must be a number.
per_page
optional

Number of results per page to return, 'all' to return all results

Validations:

  • Must match regular expression /\A([1-9]\d*|all)\Z$/.

Search fields

Field name Type Possible values
architecture string
boot_time datetime
build true, false
build_status built, pending, token_expired, build_failed
comment text
compute_resource string
compute_resource_id integer
configuration_status.applied integer
configuration_status.enabled true, false
configuration_status.failed integer
configuration_status.failed_restarts integer
configuration_status.interesting true, false
configuration_status.pending integer
configuration_status.restarted integer
configuration_status.skipped integer
created_at datetime
domain string
domain_id integer
facts string
global_status ok, warning, error
has_ip string
has_ip6 string
has_mac string
hostgroup string
hostgroup_fullname string
hostgroup_id integer
hostgroup_name string
hostgroup_title string
id integer
image string
infrastructure_facet.foreman true, false
infrastructure_facet.smart_proxy_id integer
installed_at datetime
ip string
ip6 string
last_report datetime
location string
location_id integer
mac string
managed true, false
model string
name string
organization string
organization_id integer
origin string
os string
os_description string
os_id integer
os_major string
os_minor string
os_title string
owner string
owner_id integer
owner_type string
params string
params_name string
parent_hostgroup string
puppet_ca string
puppet_proxy_id integer
puppetmaster string
pxe_loader PXELinux_BIOS, PXELinux_UEFI, Grub2_BIOS, Grub2_ELF, Grub2_UEFI, Grub2_UEFI_SecureBoot, Grub2_UEFI_HTTP, Grub2_UEFI_HTTPS, Grub2_UEFI_HTTPS_SecureBoot, iPXE_Embedded, iPXE_UEFI_HTTP, iPXE_Chain_BIOS, iPXE_Chain_UEFI
realm string
realm_id integer
reported.bios_release_date string
reported.bios_vendor string
reported.bios_version string
reported.boot_time datetime
reported.cores integer
reported.disks_total integer
reported.kernel_version string
reported.ram integer
reported.sockets integer
reported.virtual true, false
smart_proxy string
status.applied integer
status.enabled true, false
status.failed integer
status.failed_restarts integer
status.interesting true, false
status.pending integer
status.restarted integer
status.skipped integer
subnet string
subnet.name text
subnet6 string
subnet6.name text
user.firstname string
user.lastname string
user.login string
user.mail string
usergroup string
usergroup.name string
uuid string