# Use Cases
source: https://developer.mastercard.com/riskrecon-api/documentation/use-cases/index.md

## Overview {#overview}

Each use case walks you through the functionality of an endpoint and describes how you can leverage the RiskRecon APIs to control and maintain the cybersecurity hygiene of your business.

In every use case, you can know in detail the following about an endpoint:

* The endpoint overview
* Sequence diagram showing the endpoint process flow
* Steps to execute the endpoint
* Link to sample request and response for the endpoint
* Use case examples describing how you can leverage the endpoint in a real-world scenario
* The endpoint YAML

<br />

For more details on sample requests and responses, and JSON samples refer to [Testing](https://developer.mastercard.com/riskrecon-api/documentation/testing/index.md) and [API Reference](https://developer.mastercard.com/riskrecon-api/documentation/api-reference/index.md), respectively.

## Use Cases {#use-cases}

The following use cases are provided:

|                                                                 Use Case Category                                                                 |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        Use Cases                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
|---------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [Portfolio Management](https://developer.mastercard.com/riskrecon-api/documentation/use-cases/portfolio-management/index.md)                      | Manage your portfolio through the APIs discussed in the following use cases: * [Retrieve and Update TOEs and Portfolio details](https://developer.mastercard.com/riskrecon-api/documentation/use-cases/portfolio-management/portfolio/index.md) * [Retrieve a List of Subsidiaries associated with a TOE](https://developer.mastercard.com/riskrecon-api/documentation/use-cases/portfolio-management/subsidiaries/index.md)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| [Risk Assessment](https://developer.mastercard.com/riskrecon-api/documentation/use-cases/risk-assessment/index.md)                                | Assess your risk through the APIs discussed in the following use cases: * [Retrieve Current Analysis Summary of a TOE or TOEs](https://developer.mastercard.com/riskrecon-api/documentation/use-cases/risk-assessment/analysis-summary/index.md) * [Retrieve Ratings and Trending Data of a TOE](https://developer.mastercard.com/riskrecon-api/documentation/use-cases/risk-assessment/analysis/index.md) * [Retrieve Findings Data](https://developer.mastercard.com/riskrecon-api/documentation/use-cases/risk-assessment/findings/index.md) * [Retrieve Data Loss Events](https://developer.mastercard.com/riskrecon-api/documentation/use-cases/risk-assessment/datalossevent/index.md) * [Retrieve Compliance Assessments](https://developer.mastercard.com/riskrecon-api/documentation/use-cases/risk-assessment/compliance/index.md) * [Retrieve Hosts](https://developer.mastercard.com/riskrecon-api/documentation/use-cases/risk-assessment/hosts/index.md) * [Retrieve TOEs by their CVE IDs](https://developer.mastercard.com/riskrecon-api/documentation/use-cases/risk-assessment/toe-by-cve-id/index.md) |
| [Risk Management and Issue Remedification](https://developer.mastercard.com/riskrecon-api/documentation/use-cases/risk-mgmt-issue-rmdfn/index.md) | Manage your risks and remedify issues through the APIs discussed in the following use cases: * [Retrieve Action Plan Details](https://developer.mastercard.com/riskrecon-api/documentation/use-cases/risk-mgmt-issue-rmdfn/actionplan/index.md) * [Retrieve Alerts](https://developer.mastercard.com/riskrecon-api/documentation/use-cases/risk-mgmt-issue-rmdfn/alerting/index.md) * [Generate TOE PDF Reports](https://developer.mastercard.com/riskrecon-api/documentation/use-cases/risk-mgmt-issue-rmdfn/toe-pdf-reports/index.md)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| [Navigation and Access](https://developer.mastercard.com/riskrecon-api/documentation/use-cases/navigation-and-access/index.md)                    | Simplify navigation and access through the APIs discussed in the following use cases: * [Retrieve Integration Routes](https://developer.mastercard.com/riskrecon-api/documentation/use-cases/navigation-and-access/integrationroutes/index.md) * [Retrieve Display Names](https://developer.mastercard.com/riskrecon-api/documentation/use-cases/navigation-and-access/displayname/index.md)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| [User Management](https://developer.mastercard.com/riskrecon-api/documentation/use-cases/user/index.md)                                           | Manage your user data through the API discussed in the [Retrieve User Data](https://developer.mastercard.com/riskrecon-api/documentation/use-cases/user/retrieve-user-data/index.md) use case.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |

## Pagination Metadata {#pagination-metadata}

To limit or filter the data returned in the response, you can set the following parameters in the API request:

* **Page number**: Returns only the specific page from the findings. The default value is 1.
* **Results per page**: Returns a limited number of findings per page. The default value is 20 and the maximum value is 50.
* **Sort attribute**: Returns the findings sorted on fields like days_open, security_criteria, asset_value, severity, and priority
* **Sort method**: Returns the findings sorted either in ascending or descending manner. The valid values are ASC (default value) or DESC.
* **Current page**: Returns the current page of paginated responses.
* **Next page**: Returns the next page of paginated responses if applicable.
* **Previous page**: Returns the previous page of paginated responses if applicable.
* **Total count**: Returns the total count of items.
* **Total pages**: Returns the total number of pages for paginated responses.