---
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}`

## Request

- Base URL: `https://api.sandbox.riskrecon.com`
- URL: `https://api.sandbox.riskrecon.com/v1/hosts/{toe_id}`
- Auth: HTTP bearer

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.dev/recordedfuture/apis/mastercard-riskrecon-api.md) - [All operations](https://skmtc.dev/recordedfuture/apis/mastercard-riskrecon-api/llms.txt) - [OpenAPI document](https://skmtc.dev/recordedfuture/apis/mastercard-riskrecon-api/revisions/212ef0eeee9b?raw)