# Retrieve TOEs by their Domain or Hostname
source: https://developer.mastercard.com/riskrecon-api/documentation/use-cases/portfolio-management/portfolio/retrieve-toe-by-domain/index.md

## Overview {#overview}

The `GET TOES By Domain` endpoint searches or retrieves all the TOEs by their domain or hostname. The search results could include TOEs that are being scanned by RiskRecon, whether or not they are included in your portfolio.

You must to provide the domain name (`domain`) in the request body of this endpoint.

## Sequence Diagram {#sequence-diagram}

The following diagram shows how to retrieve TOEs by a domain or hostname:
Diagram retrieve-toes-by-domain

## Execution Steps {#execution-steps}

The following steps describe how to retrieve TOEs by a domain or hostname:

1. The user sends a `GET` request to retrieve all the TOEs by a domain or hostname.
2. RiskRecon retrieves the details of all the TOEs for the requested domain or hostname.

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

For a sample response for this API, see [Get TOEs by their Domain or Hostname](https://developer.mastercard.com/riskrecon-api/documentation/testing/toe-samples/retrve-toes-dom-smpl/index.md).

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

The use case [Retrieve TOEs by domain](https://developer.mastercard.com/riskrecon-api/documentation/use-cases/portfolio-management/portfolio/retrieve-toe-by-domain/index.md#retrieve-toes-by-domain) discusses how you can use the `GET TOEs by Domain` endpoint to find the TOE ID of a TOE using the TOE's domain:

### Retrieve TOEs by domain {#retrieve-toes-by-domain}

The user needs to add a new TOE to their portfolio, but they only have the TOE domain and not the TOE ID. The user can use the `GET TOEs by Domain` endpoint to search for a TOE by a valid domain. Using the TOE ID retrieved in the search result, the user can subsequently add the TOE to their portfolio through a `POST TOE` request on the TOE endpoint.

## Endpoint {#endpoint}


API Reference: `GET /v1/toes/by_domains`