---
title: "Get portfolio ratings report"
method: GET
path: "/v1/reports/portfolio_ratings"
tags: ["Reports"]
---

# Get portfolio ratings report

`GET /v1/reports/portfolio_ratings`

## Request

- Base URL: `https://api.sandbox.riskrecon.com`
- URL: `https://api.sandbox.riskrecon.com/v1/reports/portfolio_ratings`
- Auth: HTTP bearer

Retrieves a paginated list of portfolio ratings with their changes over time

## Query parameters

- `page` integer
- `per_page` integer
- `sort_attribute` 'start_date' | 'end_date' | 'vendor_name' | 'folder' | 'criticality' | 'start_rating' | 'end_rating' | 'rating_change'
- `sort_method` 'ASC' | 'DESC'
- `days_ago` integer

## Response `200`

OK

- PaginatedPortfolioRatingsReport
  - `meta` PaginationMeta
    - `current_page` integer: The current page of paginated responses.
    - `next_page` integer, nullable: The next page of paginated responses if applicable.
    - `prev_page` integer, nullable: The previous page of paginated responses if applicable.
    - `total_count` integer: The total count of items.
    - `total_pages` integer: The total number of pages for paginated responses.
  - `data` PortfolioRating[]: Data associated with response object.
    - `criticality` string: Criticality level of the portfolio item
    - `end_date` string: End date of the rating period
    - `end_rating` string: Final rating score
    - `folder` string: Portfolio folder name
    - `industry` string: The category of the industry.
    - `internal_id` string, nullable: The user defined identifiers for the TOE.
    - `internal_name` string[], nullable: The user defined names for the TOE.
    - `rating_change` string: Change in rating between start and end dates
    - `start_date` string: Start date of the rating period
    - `start_rating` string: Initial rating score
    - `vendor_name` string: Name of the vendor

## Other responses

- `400`: Something was wrong with the request
- `401`: Authentication information was missing or invalid or the user is not authorized to access resource or perform the associated action.
- `403`: FORBIDDEN
- `404`: The URI didn't match an existing resource.

---

[API](https://skmtc.dev/recordedfuture/apis/mastercard-riskrecon-api.md) - [All operations](https://skmtc.dev/recordedfuture/apis/mastercard-riskrecon-api/llms.txt) - [OpenAPI document](https://skmtc.dev/recordedfuture/apis/mastercard-riskrecon-api/revisions/212ef0eeee9b?raw)