# Retrieve a List of TOE PDF Reports Ordered
source: https://developer.mastercard.com/riskrecon-api/documentation/use-cases/risk-mgmt-issue-rmdfn/toe-pdf-reports/retrve-toe-reps/index.md

## Overview {#overview}

The `GET TOE Report` endpoint retrieves a list of all the active TOE PDF reports you have requested for in the last 24 hours. This information helps you to keep a record of the reports you have generated.

This endpoint returns the following values in the response:

* `analysis_id`: The current analysis ID of the TOE for which the report is requested.
* `request_id`: The order ID of the TOE PDF report request.
* `report_key`: The name of the TOE PDF report requested.
* `status`: The status of the TOE PDF report order or request. The status of the report can be any one of the following:
  * *created*: the initial state when the request is created but not yet processed
  * *pending*: the request has been picked up for processing
  * *ready*: the request has been processed and the report is ready to be downloaded
  * *downloaded*: the report has been downloaded
  * *error*: there was a error processing the request and will not be retried.
* `toe_id`: The TOE ID for which the report is requested.
* `toe_name`: The TOE name for which the report is requested.

## Sequence Diagram {#sequence-diagram}

The following diagram shows how to retrieve a list of all active TOE PDF report requests:
Diagram retrieve-toe-rep-ord-sts1

## Execution Steps {#execution-steps}

The following steps describe how to retrieve a list of all active TOE PDF report requests:

1. The user sends a GET request to retrieve a list of all active TOE PDF report requests.
2. RiskRecon returns the list of all active TOE PDF report requests.

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

For a sample request and response of this API, see [Get a List of TOE PDF Reports Ordered](https://developer.mastercard.com/riskrecon-api/documentation/testing/toe-pdf-rep-samples/retrve-toe-rep-smpl/index.md).

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

The use case [Conducting vendor security audits](https://developer.mastercard.com/riskrecon-api/documentation/use-cases/risk-mgmt-issue-rmdfn/toe-pdf-reports/retrve-toe-reps/index.md#conducting-vendor-security-audits) discusses how you can use the `GET TOE Report` endpoint to check the current status of the TOE PDF reports you have ordered.

### Conducting vendor security audits {#conducting-vendor-security-audits}

A RiskRecon customer is conducting security audits to evaluate the security posture of its vendors. The customer has requested for TOE PDF reports using the `POST TOE Report` endpoint.

The customer can now use the `GET TOE Report` endpoint to retrieve a list of all the active TOE PDF reports requested for in the last 24 hours.

## Endpoint {#endpoint}


API Reference: `GET /v1/toe_reports`