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

# Get portfolio ratings report

`GET /v1/reports/portfolio_ratings`

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/alert-api.md) · [All operations](https://skmtc.dev/recordedfuture/apis/alert-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/recordedfuture/alert-api/revisions/c8c2f68d8b60/schema)