# Get Hosts-Related Operations
source: https://developer.mastercard.com/riskrecon-api/documentation/testing/hosts-samples/hosts-smpl/index.md

Allows you to fetch a list of hosts and host-related data.

## Pre-requisites {#pre-requisites}

Refer to the [Retrieve Hosts-Related Operations](https://developer.mastercard.com/riskrecon-api/documentation/use-cases/risk-assessment/hosts/retrve_host_ops/index.md) use case.

## Request URL for Sandbox environment {#request-url-for-sandbox-environment}

    GET https://api.sandbox.riskrecon.com/v1/hosts/{toe_id}

## Request URL for Production environment {#request-url-for-production-environment}

    GET https://api.riskrecon.com/v1/hosts/{toe_id}

## Test Cases {#test-cases}

### Test Case: Success - Retrieve a list of hosts and host-related data {#test-case-success---retrieve-a-list-of-hosts-and-host-related-data}

**Request**

Here is an example of a request made using a `curl` command.

```bash
curl -X 'GET' \
  'https://api.sandbox.riskrecon.com/v1/hosts/09918d09-8d52-4e86-a3ec-5ef4d461e2ba' \
  -H 'accept: application/json'
  -H 'Authorization: valid_JWT_token'
```

**Response**

get:

```json
[
  {
    "analysis_id": "9420400",
    "asset_value": "medium",
    "asset_value_numeric": "3",
    "auth_detected": "yes",
    "city_name": "Lurline",
    "continent_code": "OC",
    "continent_name": "Oceania",
    "country_iso_code": "HK",
    "country_name": "Liechtenstein",
    "domain_name": "rutherford.org",
    "form_field_types_detected": "",
    "host_name": "boyer.org",
    "hosting_provider": "Lockman Group",
    "hosting_type": "external",
    "ip_addr": "171.43.10.134",
    "is_web": "1",
    "latitude": "77.8559",
    "longitude": "0.0876",
    "metro_code": "",
    "netblock_id": "25.61.68.247/13",
    "netblock_scan_status": "0",
    "postal_code": "14682",
    "record_load_timestamp": "2022-02-09 21:04:47.429380",
    "scan_http": "0",
    "service": "email",
    "subdivision_1_iso_code": "",
    "subdivision_1_name": ""
  },
  {
    "analysis_id": "9420400",
    "asset_value": "low",
    "asset_value_numeric": "2",
    "auth_detected": "no",
    "city_name": "Elda",
    "continent_code": "SA",
    "continent_name": "South America",
    "country_iso_code": "KZ",
    "country_name": "Dominica",
    "domain_name": "huels.name",
    "form_field_types_detected": "",
    "host_name": "mckenzie.info",
    "hosting_provider": "Baumbach, Bergnaum and Hahn",
    "hosting_type": "external",
    "ip_addr": "220.240.74.47",
    "is_web": "",
    "latitude": "-51.2396",
    "longitude": "17.8524",
    "metro_code": "",
    "netblock_id": "89.134.216.247/13",
    "netblock_scan_status": "0",
    "postal_code": "40578",
    "record_load_timestamp": "2022-02-09 21:04:47.429380",
    "scan_http": "0",
    "service": "web",
    "subdivision_1_iso_code": "",
    "subdivision_1_name": ""
  },
]
```

### Test Case: Fail - Non-existing TOE ID {#test-case-fail---non-existing-toe-id}

**Request**

Here is an example of a request made with a non-existing TOE ID using a `curl` command.

```bash
curl -X 'GET' \
  'https://api.sandbox.riskrecon.com/v1/hosts/5976423a-ee35-11e3-8569-14109ff1a304' \
  -H 'accept: application/json'
  -H 'Authorization: valid_JWT_token'
```

**Response**

HTTP Error response 404

```json
{
  "Errors": {
    "Error": [
      {
        "Description": "Resource Not found.",
        "Details": null,
        "ReasonCode": "NOT_FOUND",
        "Recoverable": false,
        "Source": "RISKRECON_API"
      }
    ]
  }
}
```