---
title: "This resource returns any rating/score changes from new scans in the users portfolio based on the users alert settings."
method: GET
path: "/v1/alerting/rating_changes"
tags: ["Alerts"]
---

# This resource returns any rating/score changes from new scans in the users portfolio based on the users alert settings.

`GET /v1/alerting/rating_changes`

## Request

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

This resource returns any rating/score changes from new scans in the users portfolio based on the users alert settings. Alert settings can be changed at https://portal.riskrecon.com/portal/alert-center/alert-settings.

## Query parameters

- `page` integer
- `per_page` integer
- `sort_method` 'ASC' | 'DESC'
- `start_date` string, date
- `end_date` string, date
- `alert_types[]` string[]
- `sort_attribute` 'company' | 'security_domain' | 'previous_rating' | 'new_rating' | 'rating_change' | 'date'

## Response `200`

OK

- AlertingScoreChanges
  - `meta` object
    - `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.
    - `total_new` integer: The total number of new score changes.
  - `rating_change_alerts` AlertingScoreChange[]
    - `id` integer: The alert identifier.
    - `new` boolean: Is this alert new? Was it found in the most recent scan?
    - `seen` boolean: Has this alert been marked as seen on the riskrecon site?
    - `company_name` string: The name of the company.
    - `security_domain_key` string: The security_domain category for the finding.
    - `risk_structure` string: The category of the TOE. Uncategorized by default.
    - `alert_type` string: The type of score change alert.
    - `previous_rating` object
      - `letter` string: The letter rating of the previous rating.
      - `value` string: The numeric rating of the previous rating.
    - `new_rating` object
      - `letter` string: The letter rating of the new rating.
      - `value` string: The numeric rating of the new rating.
    - `rating_change` string, nullable: The rating change from the previous and new ratings.
    - `date` string: The date of the alert.
    - `current_analysis` string: The current analysis_id for the TOE.

## 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.

---

[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)