# Retrieve Hosts-Related Operations
source: https://developer.mastercard.com/riskrecon-api/documentation/use-cases/risk-assessment/hosts/retrve_host_ops/index.md

## Overview {#overview}

The `GET Hosts` endpoint provides you a list of hosts and host-related data, such as their location and time of activity for the most recent analysis. You must provide the `toe_id` as the API request parameter to retrieve all its hosts and their data.

### View hosts on the RiskRecon portal {#view-hosts-on-the-riskrecon-portal}

You can also find this information on the **IT Profile page** of the **RiskRecon web portal**:

![](https://static.developer.mastercard.com/content/riskrecon-api/uploads/hosts.png)

## Sequence Diagram {#sequence-diagram}

The following diagram shows how to retrieve the hosts and host-related data associated with a TOE:
Diagram retrieve-hosts

## Execution Steps {#execution-steps}

The following steps describe how to retrieve the hosts and host-related data associated with a TOE:

1. The user sends a `GET` request to retrieve all the hosts and host-related data associated with a TOE and provides the `toe_id` as the input parameter.
2. RiskRecon retrieves all the hosts and host-related data associated with the TOE.

## Sample Request and Response {#sample-request-and-response}

For a sample response for this API, see [Get Hosts-Related Operations](https://developer.mastercard.com/riskrecon-api/documentation/testing/hosts-samples/hosts-smpl/index.md).

## Use Case Example {#use-case-example}

The [Find a reliable vendor to expand business](https://developer.mastercard.com/riskrecon-api/documentation/use-cases/risk-assessment/hosts/retrve_host_ops/index.md#find-a-reliable-vendor-to-expand-business) use case discusses how you can use the `GET Hosts` endpoint to retrieve all the hosts associated with a TOE.

### Find a reliable vendor to expand business {#find-a-reliable-vendor-to-expand-business}

A RiskRecon customer is vetting a vendor and wants to know the size of the vendor's public-facing digital footprint, geolocations, and hosting providers. The user can use the `GET Hosts` endpoint to retrieve a list of the vendor's current hosts and host-related data, such as host names, locations, domain names, asset values, IP addresses, service type, and hosting type. The user can then review the geolocations of the hosts and decide if the locations are a risk for their business. The user can also decide if the providers are a risk for them or not. This information helps the customer decide if they want to extend business relationships to the vendor.

## Endpoint {#endpoint}


API Reference: `GET /v1/hosts/{toe_id}`