# Retrieve a TOE by its Identifier
source: https://developer.mastercard.com/riskrecon-api/documentation/use-cases/risk-assessment/analysis-summary/retrieve-a-toe/index.md

## Overview {#overview}

The `GET TOE` endpoint retrieves the current analysis summary of a TOE by using the `toe_id` as the API request parameter. The `toe_id` is a unique identifier assigned by RiskRecon.

The current analysis summary includes the current analysis ID and timestamp of the TOE, the current overall rating, and the security domain ratings for the TOE.

## Sequence Diagram {#sequence-diagram}

The following diagram shows how to retrieve the current analysis summary of a TOE:
Diagram retrieve-a-toe

## Execution Steps {#execution-steps}

The following steps describe how to retrieve the current analysis summary of a TOE:

1. The user sends a `GET` request to retrieve the current analysis summary of a TOE and provides the `toe_id` as the input parameter.
2. RiskRecon provides the current analysis summary of the requested TOE.

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

For a sample response for this API, see [Get a TOE by its Identifier](https://developer.mastercard.com/riskrecon-api/documentation/testing/toe-samples/retrve-a-toe-smpl/index.md).

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

The [Retrieve current analysis summary of a vendor](https://developer.mastercard.com/riskrecon-api/documentation/use-cases/risk-assessment/analysis-summary/retrieve-a-toe/index.md#retrieve-current-analysis-summary-of-a-vendor) use case discusses how you can use the `GET TOE` endpoint to retrieve the current analysis summary of a TOE:

### Retrieve current analysis summary of a vendor {#retrieve-current-analysis-summary-of-a-vendor}

A user has added a TOE to the portfolio. The user can now use the `GET TOE` endpoint to retrieve data about the TOE including the current overall rating and the security domains ratings for the current analysis of the TOE.

## Endpoint {#endpoint}


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