# GET Portfolio Ratings Report Data
source: https://developer.mastercard.com/riskrecon-api/documentation/use-cases/portfolio-management/portfolio/get-port-ratings-rept/index.md

## Overview {#overview}

The `GET Portfolio Ratings Report` endpoint retrieves a paginated list of overall rating changes for entities within your portfolio over a specified time period. By comparing the current overall ratings to ratings from a defined point in the past, the endpoint enables users to identify trends, measure improvement or degradation, and uncover insights across their portfolio.

The endpoint allows you to specify how many days ago to look back, and the response will return the current rating, the historical rating closest to that time, and the difference between the two. This historical comparison helps to support performance tracking, compliance reporting, and strategic decision-making.

Note: Ratings from the "days ago" parameter are based on the closest available analysis for a given vendor to that specified time.

## Sequence Diagram {#sequence-diagram}

Diagram get-port-ratings-rept

## Execution Steps {#execution-steps}

The following steps describe how to get the Portfolio Ratings report:

1. The user sends a `GET` request specifying the desired number of days in the past.

2. RiskRecon returns the current overall ratings of portfolio entities, corresponding historical ratings from the specified point in time, and the calculated difference between current and past ratings for each entity.

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

For a sample response for this API, see [Get Portfolio Ratings Report](https://developer.mastercard.com/riskrecon-api/documentation/testing/portfolio-samples/get-port-ratings-rept-smpl/index.md).

## Use Case Examples {#use-case-examples}

The use case in this section discusses how you can use the `GET Portfolio Ratings Report` to:

### Ongoing Monitoring and Risk Management {#ongoing-monitoring-and-risk-management}

Use this API to track trends across your third-party ecosystem by:

* Monitoring whether vendors are improving or deteriorating in overall security posture.
* Identifying vendors with declining ratings that may require intervention.
* Evaluating the impact of security initiatives or engagement with vendors over time.

You can set automated periodic reviews (for example, monthly or quarterly) using this API to continuously assess vendor risk exposure and remediation progress.

## Endpoint {#endpoint}


API Reference: `GET /v1/reports/portfolio_ratings`