# Retrieve a Collection of TOE Objects
source: https://developer.mastercard.com/riskrecon-api/documentation/use-cases/risk-assessment/analysis-summary/retrieve-a-toe-collection/index.md

## Overview {#overview}

The `GET TOEs` endpoint retrieves the current analysis summary of all the TOEs in your portfolio that match the filter criteria. You can filter the TOEs by a TOE's internal ID, and/or its last analyzed date and time.

A TOE can have multiple internal IDs. This endpoint filters the summary of the analysis that were published on or after the last analyzed date for the internal IDs that match the filter criteria.

The data returned includes the unique identifier `toe_id` assigned by RiskRecon, the last analyzed ID and timestamp, the overall rating, and the security domain ratings for each TOE.

## Sequence Diagram {#sequence-diagram}

The following diagram shows how to retrieve the summary of the analysis of the TOEs matching the filter criteria:
Diagram retrieve-toe-collections

## Execution Steps {#execution-steps}

The following steps describe how to retrieve the summary of the analysis of the TOEs matching the filter criteria:

1. The user sends a `GET` request to retrieve the current analysis summary of a collection of TOEs and puts the internal IDs and the last analyzed date and time of the TOEs 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 Collection of TOE Objects](https://developer.mastercard.com/riskrecon-api/documentation/testing/toe-samples/retrve-a-toe-coll-smpl/index.md).

## Use Case Examples {#use-case-examples}

The use cases in this section discuss how you can use the `GET TOEs` endpoint to retrieve the current analysis summary of a TOE:

* [Retrieve current analysis summary of a new vendor](https://developer.mastercard.com/riskrecon-api/documentation/use-cases/risk-assessment/analysis-summary/retrieve-a-toe-collection/index.md#retrieve-current-analysis-summary-of-a-new-vendor)
* [Retrieve daily updates of all vendors](https://developer.mastercard.com/riskrecon-api/documentation/use-cases/risk-assessment/analysis-summary/retrieve-a-toe-collection/index.md#retrieve-daily-updates-of-all-vendors)

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

An organization has added a new vendor (TOE) to its supply chain. It has added the TOE to its portfolio and RiskRecon has published the analysis of this new addition. Now that the new TOE has been added, the user can use the `GET TOEs` endpoint to retrieve data about the TOE including the overall rating and the security domain ratings for the current analysis of the TOE.

### Retrieve daily updates of all vendors {#retrieve-daily-updates-of-all-vendors}

Suppose a customer monitors 50 vendors (TOEs) and wants to pull the new ratings of the TOEs daily. Instead of iterating through all 50 vendors, they can use the `GET TOEs` endpoint to filter on the previous day as the last analysis date to check for any updated or new analysis published on that day.

## Endpoint {#endpoint}


API Reference: `GET /v1/toes`