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

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

## Pre-requisites {#pre-requisites}

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

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

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

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

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

## Test Cases {#test-cases}

### Test Case: Success - Retrieve current analysis of a TOE {#test-case-success---retrieve-current-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/current/09918d09-8d52-4e86-a3ec-5ef4d461e2ba?include_trend=true' \
  -H 'accept: application/json' 
  -H 'Authorization: valid_JWT_token'
```

Note: Use the `include_trend` parameter to retrieve trending data for rating differences between the current analysis and the previous analysis for the TOE. This parameter takes in boolean values of either `true` or `false`. The default value of this parameter is `false`. If you enter any other value such as, `yes` or `no`, the API ignores the user provided value and considers the default value of the parameter.

**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
}
```

Note: The `rating` is a legacy field and shows the ratings as per the old scoring model.   

### Test Case: Fail - No existing resource found {#test-case-fail---no-existing-resource-found}

**Request**

Here is an example of a request made by using an incorrect URL in the `curl` command.

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

**Response**

HTTP Error response 404

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

