---
title: "Get all hosts for your organization"
method: GET
path: "/api/v1/hosts"
tags: ["Hosts"]
---

# Get all hosts for your organization

`GET /api/v1/hosts`

This endpoint allows searching for hosts by name, alias, or tag.
Hosts live within the past 3 hours are included by default.
Retention is 7 days.
Results are paginated with a max of 1000 results at a time.
**Note:** If the host is an Amazon EC2 instance, `id` is replaced with `aws_id` in the response.
**Note**: To enrich the data returned by this endpoint with security scans, see the new [api/v2/security/scanned-assets-metadata](https://docs.datadoghq.com/api/latest/security-monitoring/#list-scanned-assets-metadata) endpoint.

## Query parameters

- `filter` string
- `sort_field` string
- `sort_dir` string
- `start` integer
- `count` integer
- `from` integer
- `include_muted_hosts_data` boolean
- `include_hosts_metadata` boolean

## Response `200`

OK

- HostListResponse — Response with Host information from Datadog.
  - `host_list` Host[] — Array of hosts.
    - `aliases` string[] — Host aliases collected by Datadog.
    - `apps` string[] — The Datadog integrations reporting metrics for the host.
    - `aws_name` string — AWS name of your host.
    - `host_name` string — The host name.
    - `id` integer — The host ID.
    - `is_muted` boolean — If a host is muted or unmuted.
    - `last_reported_time` integer — Last time the host reported a metric data point.
    - `meta` HostMeta — Metadata associated with your host.
      - `agent_checks` AgentCheck[] — A list of Agent checks running on the host.
        - unknown[] — Array of strings.
          - unknown
      - `agent_version` string — The Datadog Agent version.
      - `cpuCores` integer — The number of cores.
      - `fbsdV` string[] — An array of Mac versions.
      - `gohai` string — JSON string containing system information.
      - `install_method` HostMetaInstallMethod — Agent install method.
        - `installer_version` string — The installer version.
        - `tool` string — Tool used to install the agent.
        - `tool_version` string — The tool version.
      - `macV` string[] — An array of Mac versions.
      - `machine` string — The machine architecture.
      - `nixV` string[] — Array of Unix versions.
      - `platform` string — The OS platform.
      - `processor` string — The processor.
      - `pythonV` string — The Python version.
      - `socket-fqdn` string — The socket fqdn.
      - `socket-hostname` string — The socket hostname.
      - `winV` string[] — An array of Windows versions.
    - `metrics` HostMetrics — Host Metrics collected.
      - `cpu` number, double — The percent of CPU used (everything but idle).
      - `iowait` number, double — The percent of CPU spent waiting on the IO (not reported for all platforms).
      - `load` number, double — The system load over the last 15 minutes.
    - `mute_timeout` integer, nullable — Timeout of the mute applied to your host.
    - `name` string — The host name.
    - `sources` string[] — Source or cloud provider associated with your host.
    - `tags_by_source` object — List of tags for each source (AWS, Datadog Agent, Chef..).
    - `up` boolean — Displays UP when the expected metrics are received and displays `???` if no metrics are received.
  - `total_matching` integer — Number of host matching the query.
  - `total_returned` integer — Number of host returned.

## Other responses

- `400` — Invalid Parameter Error
- `403` — Forbidden
- `429` — Too many requests

---

[API](https://skmtc.net/datadog/apis/api-v1.md) · [All operations](https://skmtc.net/datadog/apis/api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/datadog/api-v1/revisions/ca5871004d26/schema)