---
title: "This resource returns a list of Hosts for latest analysis for a given TOE."
method: GET
path: "/v1/hosts/{toe_id}"
tags: ["Hosts"]
---

# This resource returns a list of Hosts for latest analysis for a given TOE.

`GET /v1/hosts/{toe_id}`

This resource returns a list of Hosts for latest analysis for a given TOE. This includes domain and netblock information as well.

## Path parameters

- `toe_id` string, required

## Response `200`

OK

- Host[] — A collection of Hosts.
  - `subdivision_1_name` string, nullable — The subdivision name if applicable.
  - `subdivision_1_iso_code` string, nullable — The subdivision ISO if applicable.
  - `service` string — The type of service associated with host.
  - `scan_http` string — The company owns this resource and it should be scanned if possible. The value can be 0 or 1.
  - `record_load_timestamp` string — The timestamp for when record was loaded.
  - `postal_code` string, nullable — The postal code associated with host if available.
  - `netblock_scan_status` string, nullable — The status of the netblock scan.
  - `netblock_id` string, nullable — The netblock id associated with the host.
  - `metro_code` string, nullable — The metro code associated with the host if available.
  - `longitude` string, nullable — The latitude associated with the host if available.
  - `latitude` string, nullable — The longitude associated with the host if available.
  - `is_web` string — Was a web server found? The value can be 0 or 1.
  - `ip_addr` string — The ip address associated with the host.
  - `hosting_type` string — Is it hosted internally or externally? The value can be internal or external.
  - `hosting_provider` string, nullable — The hosting provider if available.
  - `host_name` string, nullable — The name of the host.
  - `form_field_types_detected` string, nullable — Any form fields detected.
  - `domain_name` string, nullable — The domain name if available.
  - `country_name` string, nullable — The name of country if available.
  - `country_iso_code` string, nullable — The country ISO code if available.
  - `continent_name` string, nullable — The continent if available.
  - `continent_code` string, nullable — The continent code if available.
  - `city_name` string, nullable — The city name if available.
  - `auth_detected` string — Was the host auto detected? The value can be yes or no.
  - `asset_value_numeric` string — The numeric asset value associated with the host.
  - `asset_value` string — The asset value associated with host. The value can be high, medium, low or idle.
  - `analysis_id` string — The unique identifier for an Analysis.

## Other responses

- `401` — Authentication information was missing or invalid or the user is not authorized to access resource or perform the associated action.
- `403` — FORBIDDEN
- `404` — The URI didn't match an existing resource.

---

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