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

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