# Get Historical Analysis of a TOE
source: https://developer.mastercard.com/riskrecon-api/documentation/testing/analysis-samples/hist-analysis-smpl/index.md

Allows you to fetch historical analysis details and trending data of a vendor.

## Pre-requisites {#pre-requisites}

Refer to the [Retrieve Historical Analysis of a TOE](https://developer.mastercard.com/riskrecon-api/documentation/use-cases/risk-assessment/analysis/historical-analysis/index.md) use case.

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

```bash
GET https://api.sandbox.riskrecon.com/v1/analysis/history/{toe_id}
```

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

```bash
GET https://api.riskrecon.com/v1/analysis/history/{toe_id}
```

## Test Cases {#test-cases}

### Test Case: Success - Retrieve historical analysis of a TOE {#test-case-success---retrieve-historical-analysis-of-a-toe}

**Request**

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

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

**Response**

get:

```json
[
  {
    "analysis_id": "9420400",
    "analysis_ts": "2022-03-14 19:24:58 UTC",
    "rating": "proceed",
    "rating_numeric": 7.5,
    "rating_v2": "b",
    "security_domain_ratings": {
      "data_loss": {
        "rating_v2": "b",
        "trend": 4.4,
        "data_loss_12": {
          "rating_v2": "f",
          "trend": -0.5,
          "rating": "fix",
          "rating_numeric": 2.6
        },
        "data_loss_24": {
          "rating_v2": "d",
          "trend": -3.9,
          "rating": "fix",
          "rating_numeric": 4.2
        },
        "data_loss_36": {
          "rating_v2": "f",
          "trend": -0.1,
          "rating": "fix",
          "rating_numeric": 3.4
        },
        "data_loss_36plus": {
          "rating_v2": "a",
          "trend": 4.7,
          "rating": "proceed",
          "rating_numeric": 9.6
        },
        "data_loss_6": {
          "rating_v2": "a",
          "trend": 2.1,
          "rating": "proceed",
          "rating_numeric": 9.1
        },
        "rating": "proceed",
        "rating_numeric": 7.5
      },
      "defensibility": {
        "rating_v2": "f",
        "trend": -5.9,
        "attack_surface_web_hostname": {
          "rating_v2": "d",
          "trend": 0.3,
          "rating": "fix",
          "rating_numeric": 4.4
        },
        "attack_surface_web_ip": {
          "rating_v2": "a",
          "trend": 2.2,
          "rating": "proceed",
          "rating_numeric": 9.4
        },
        "defensibility_hosting_providers": {
          "rating_v2": "f",
          "trend": -4.2,
          "rating": "fix",
          "rating_numeric": 3.3
        },
        "rating": "fix",
        "rating_numeric": 3.1,
        "shared_hosting": {
          "rating_v2": "f",
          "trend": 0.7,
          "rating": "stop",
          "rating_numeric": 1.8
        }
      },
      "dns_security": {
        "rating_v2": "a",
        "trend": 0.2,
        "dns_hosting_providers": {
          "rating_v2": "a",
          "trend": 8.1,
          "rating": "proceed",
          "rating_numeric": 9.7
        },
        "domain_hijacking_protection": {
          "rating_v2": "c",
          "trend": -0.2,
          "rating": "limit",
          "rating_numeric": 6.7
        },
        "rating": "proceed",
        "rating_numeric": 9.1
      },
      "email_security": {
        "rating_v2": "c",
        "trend": 2.7,
        "email_authentication": {
          "rating_v2": "f",
          "trend": -2.8,
          "rating": "stop",
          "rating_numeric": 1.7
        },
        "email_encryption_enabled": {
          "rating_v2": "f",
          "trend": 0.7,
          "rating": "fix",
          "rating_numeric": 3.1
        },
        "email_hosting_providers": {
          "rating_v2": "f",
          "trend": -6.2,
          "rating": "stop",
          "rating_numeric": 2
        },
        "rating": "limit",
        "rating_numeric": 6.4
      },
      "governance": {
        "rating_v2": "d",
        "trend": -1.4,
        "governance_customer_base": {
          "rating_v2": "b",
          "trend": 1.2,
          "rating": "limit",
          "rating_numeric": 7
        },
        "governance_regulatory_requirements": {
          "rating_v2": "c",
          "trend": -2.5,
          "rating": "limit",
          "rating_numeric": 6.7
        },
        "governance_security_certifications": {
          "rating_v2": "a",
          "trend": 0.3,
          "rating": "proceed",
          "rating_numeric": 9.2
        },
        "rating": "fix",
        "rating_numeric": 4.1
      },
      "network_filtering": {
        "rating_v2": "d",
        "trend": 2,
        "iot_devices": {
          "rating_v2": "f",
          "trend": -3.5,
          "rating": "fix",
          "rating_numeric": 3.8
        },
        "rating": "fix",
        "rating_numeric": 4.9,
        "unsafe_network_services": {
          "rating_v2": "b",
          "trend": 5.9,
          "rating": "proceed",
          "rating_numeric": 8.4
        }
      },
      "software_patching": {
        "rating_v2": "a",
        "trend": 0.7,
        "patching_app_server": {
          "rating_v2": "f",
          "trend": -6.7,
          "rating": "fix",
          "rating_numeric": 2.5
        },
        "patching_vuln_open_ssl": {
          "rating_v2": "c",
          "trend": -0.7,
          "rating": "limit",
          "rating_numeric": 6.1
        },
        "patching_web_cms": {
          "rating_v2": "c",
          "trend": 3.8,
          "rating": "limit",
          "rating_numeric": 6.1
        },
        "patching_web_server": {
          "rating_v2": "f",
          "trend": -4.1,
          "rating": "stop",
          "rating_numeric": 1.2
        },
        "rating": "proceed",
        "rating_numeric": 9.4
      },
      "system_hosting": {
        "rating_v2": "a",
        "trend": 5.3,
        "host_hosting_providers": {
          "rating_v2": "c",
          "trend": -2.8,
          "rating": "limit",
          "rating_numeric": 6.2
        },
        "hosting_countries": {
          "rating_v2": "f",
          "trend": -3.1,
          "rating": "stop",
          "rating_numeric": 1.8
        },
        "rating": "proceed",
        "rating_numeric": 9.6
      },
      "threat_intell": {
        "rating_v2": "a",
        "trend": 0.5,
        "rating": "proceed",
        "rating_numeric": 9.3,
        "threatintel_botnet_host": {
          "rating_v2": "f",
          "trend": -6.4,
          "rating": "fix",
          "rating_numeric": 2.9
        },
        "threatintel_cc_server": {
          "rating_v2": "f",
          "trend": -5.3,
          "rating": "fix",
          "rating_numeric": 2.5
        },
        "threatintel_hostile_host_hacking": {
          "rating_v2": "d",
          "trend": -3.9,
          "rating": "limit",
          "rating_numeric": 5.3
        },
        "threatintel_hostile_host_scanning": {
          "rating_v2": "a",
          "trend": 5.7,
          "rating": "proceed",
          "rating_numeric": 9.2
        },
        "threatintel_other": {
          "rating_v2": "d",
          "trend": 1.1,
          "rating": "limit",
          "rating_numeric": 5.4
        },
        "threatintel_phishing_site": {
          "rating_v2": "b",
          "trend": -1.8,
          "rating": "proceed",
          "rating_numeric": 8.2
        },
        "threatintel_spamming_host": {
          "rating_v2": "c",
          "trend": 0.2,
          "rating": "limit",
          "rating_numeric": 6.3
        }
      },
      "web_app_security": {
        "rating_v2": "b",
        "trend": 3.5,
        "config_web_cms_authentication": {
          "rating_v2": "f",
          "trend": -6.3,
          "rating": "fix",
          "rating_numeric": 3.5
        },
        "rating": "proceed",
        "rating_numeric": 8,
        "threat_intel_alert_external": {
          "rating_v2": "f",
          "trend": -6.2,
          "rating": "stop",
          "rating_numeric": 1.3
        },
        "web_http_security_headers": {
          "rating_v2": "f",
          "trend": -5.2,
          "rating": "stop",
          "rating_numeric": 1.8
        }
      },
      "web_encryption": {
        "rating_v2": "c",
        "trend": 4.7,
        "rating": "limit",
        "rating_numeric": 5.9,
        "web_encryption_date_expire": {
          "rating_v2": "f",
          "trend": -5,
          "rating": "fix",
          "rating_numeric": 2.9
        },
        "web_encryption_date_valid": {
          "rating_v2": "f",
          "trend": 1.2,
          "rating": "fix",
          "rating_numeric": 2.6
        },
        "web_encryption_hash": {
          "rating_v2": "b",
          "trend": -2,
          "rating": "limit",
          "rating_numeric": 7
        },
        "web_encryption_key_length": {
          "rating_v2": "f",
          "trend": -4.5,
          "rating": "fix",
          "rating_numeric": 3.7
        },
        "web_encryption_protocol": {
          "rating_v2": "f",
          "trend": -5.9,
          "rating": "fix",
          "rating_numeric": 3.4
        },
        "web_encryption_subject": {
          "rating_v2": "f",
          "trend": -6.2,
          "rating": "stop",
          "rating_numeric": 2
        }
      }
    },
    "trend": -1.1
  }
]
```

### Test Case: Fail - Access by unauthorized user {#test-case-fail---access-by-unauthorized-user}

**Request**

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

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

**Response**

HTTP Error response 401

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