# Get a Collection of TOE Objects
source: https://developer.mastercard.com/riskrecon-api/documentation/testing/toe-samples/retrve-a-toe-coll-smpl/index.md

Allows you to retrieve a summary of the current analysis of all the TOEs in your portfolio that match the filter criteria.

## Pre-requisites {#pre-requisites}

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

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

    GET https://api.sandbox.riskrecon.com/v1/toes?internal_id=<valid internal ID>&last_retrieved=<date string in YYYY-MM-DD format>

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

    GET https://api.riskrecon.com/v1/toes?internal_id=<valid internal ID>&last_retrieved=<date string in YYYY-MM-DD format>

## Test Cases {#test-cases}

### Test Case: Success - Retrieve a summary of all the TOEs in your portfolio {#test-case-success---retrieve-a-summary-of-all-the-toes-in-your-portfolio}

**Request**

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

```bash
curl -X 'GET' \
  'https://api.riskrecon.com/v1/toes?internal_id%5B%5D=12345&last_retrieved=2020-11-20' \
  -H 'accept: application/json' \
  -H 'Authorization: <valid_JWT>'
```

**Response**

get:

```json
{
  "analysis_id": "414958",
  "analysis_ts": "2021-10-01T22:18:57+00:00",
  "analysis_type": "continuous",
  "data_loss_rating": 10,
  "defensibility_rating": 10,
  "dns_security_rating": 8.2,
  "duns_numbers": [
    "99646980"
  ],
  "email_security_rating": 9.7,
  "governance_rating": 10,
  "internal_id": [
    "12345"
  ],
  "internal_name": [
    "Some Company, Inc"
  ],
  "network_filtering_rating": 7.2,
  "rating": "fix",
  "rating_numeric": 7.1,
  "rating_v2": "b",
  "risk_configurations": [
    {
      "inherent_risk": "Critical",
      "risk_relationship": "Own Enterprise"
    }
  ],
  "seed_hostnames": [
    "example.com"
  ],
  "software_patching_rating": 9.9,
  "subscription_level": "enterprise",
  "system_hosting_rating": 5.6,
  "threat_intell_rating": 8.6,
  "ticker_symbols": [
    {
      "exchange_name": "NYSE",
      "ticker_symbol": "0023.HK"
    }
  ],
  "toe_id": "5976423a-ee35-11e3-8569-14109ff1a304",
  "toe_short_name": "Example, CO.",
  "web_app_security_rating": 3.4,
  "web_encryption_rating": 3.8
},
{
    "analysis_id": "90874567",
    "analysis_ts": "2022-03-14 19:24:58 UTC",
    "analysis_type": "one_time",
    "data_loss_rating": 4,
    "defensibility_rating": 1.8,
    "dns_security_rating": 2.9,
    "duns_numbers": [],
    "email_security_rating": 2.5,
    "governance_rating": 4.3,
    "internal_id": [
      "12345"
    ],
    "internal_name": null,
    "network_filtering_rating": 3.3,
    "rating": "limit",
    "rating_numeric": 5.1,
    "rating_v2": "d",
    "risk_configurations": [],
    "seed_hostnames": [
      "marks.com"
    ],
    "software_patching_rating": 3.7,
    "subscription_level": "auto",
    "system_hosting_rating": 7.8,
    "threat_intell_rating": 3.3,
    "ticker_symbols": [
      {
        "exchange_name": "NYSE",
        "ticker_symbol": "2682.N225"
      }
    ],
    "toe_id": "30c9a286-2d9c-4c57-329d-9b560a14cf39",
    "toe_short_name": "HML Ltd.",
    "web_app_security_rating": 4.8,
    "web_encryption_rating": 3.5
}
```

### Test Case: Fail - Expired or Invalid JWT {#test-case-fail---expired-or-invalid-jwt}

**Request**

Here is an example, using a `curl` command, of a request made with an invalid JWT.

```bash
curl -X 'GET' \
  'https://api.riskrecon.com/v1/toes?internal_id%5B%5D=12345&last_retrieved=2020-11-20' \
  -H 'accept: application/json' \
  -H 'Authorization: invalid_JWT' \'
```

**Response**

HTTP Error Response 401

```json
{
  "Errors": {
    "Error": [
      {
        "Description": "Unauthorized request",
        "Details": "Invalid JWT",
        "ReasonCode": "UNAUTHORIZED",
        "Recoverable": false,
        "Source": "RISKRECON_API"
      }
    ]
  }
}
```