# Get a TOE by its Identifier
source: https://developer.mastercard.com/riskrecon-api/documentation/testing/toe-samples/retrve-a-toe-smpl/index.md

Allows you to retrieve a summary of the current analysis of a TOE in your portfolio using its TOE ID.

## Pre-requisites {#pre-requisites}

Refer to the [Retrieve a TOE by its Identifier](https://developer.mastercard.com/riskrecon-api/documentation/use-cases/risk-assessment/analysis-summary/retrieve-a-toe/index.md) use case.

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

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

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

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

## Test Cases {#test-cases}

### Test Case: Success - Retrieve a summary of a TOE in your portfolio {#test-case-success---retrieve-a-summary-of-a-toe-in-your-portfolio}

**Request**

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

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

**Response**

get:

```json
{
  "analysis_id": "9420400",
  "analysis_ts": "2022-03-14 19:24:58 UTC",
  "analysis_type": "one_time",
  "data_loss_rating": 2.3,
  "defensibility_rating": 4.7,
  "dns_security_rating": 6.8,
  "duns_numbers": [
    "019351279"
  ],
  "email_security_rating": 5.1,
  "governance_rating": 1.3,
  "internal_id": [],
  "internal_name": [
    "Kilback, Rosenbaum and Koepp"
  ],
  "network_filtering_rating": 3.3,
  "rating": "stop",
  "rating_numeric": 1.4,
  "rating_v2": "f",
  "risk_configurations": [],
  "seed_hostnames": [
    "howell.info"
  ],
  "software_patching_rating": 7.5,
  "subscription_level": "enterprise",
  "system_hosting_rating": 3.5,
  "threat_intell_rating": 6.8,
  "ticker_symbols": [],
  "toe_id": "09918d09-8d52-4e86-a3ec-5ef4d461e2ba",
  "toe_short_name": "Fisher LLC",
  "web_app_security_rating": 5.6,
  "web_encryption_rating": 6.5
}
```

### Test Case: Fail - Non-existent JWT {#test-case-fail---non-existent-jwt}

**Request**

Here is an example, using a `curl` command, of a request made with a `toe_id` that was deleted.

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

**Response**

HTTP Error Response 404

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