# Retrieve Display Names for Security Domains
source: https://developer.mastercard.com/riskrecon-api/documentation/use-cases/navigation-and-access/displayname/rtreve-disp-nm-sec-dom/index.md

## Overview {#overview}

Using the `GET Security Domain Display Names` endpoint, you can retrieve a one-to-one mapping of each security domain name as they are presented in the API response and the RiskRecon web portal. Besides, using this endpoint also lets you know if a particular security domain is currently rated or deprecated.

Following is an example of how you can correctly match a security domain name with its display name:

Suppose the `Action Plan Findings API` for a vendor returns the findings for the following security domain, which is shown in this response snippet:

    "attributes": {
                    ........

                    "security_criteria": "unencrypted_sensitive_systems"
                    "security_domain": "web_app_security"
                    
                    ......
                  }

When you execute the `GET Security Domain Display Names` endpoint, it returns the mapping of all the security domains available, out of which you can find the display name of the `web_app_security` security domain, which is `Application Security`. This is shown in the following response snippet:

    {
            "deprecated": false,
            "display_name": "Application Security",
            "name": "web_app_security",
            "rated": true
    } 

This information helps you to understand the findings for the `Application Security` security domain and also to find its ratings on the vendor page in the RiskRecon web portal:

![](https://static.developer.mastercard.com/content/riskrecon-api/uploads/security-domain-display-name.png)

## Sequence Diagram {#sequence-diagram}

The following diagram shows how to retrieve a mapping of each security domain name as they are presented in the API response and the web portal:
Diagram retrieve-display-names-security-domain

## Execution Steps {#execution-steps}

The following steps describe how to retrieve a mapping of each security domain name as they are presented in the API response and the web portal:

1. The user sends a `GET` request to retrieve the display names of the security domains.
2. RiskRecon provides the display names of the security domains.

## Sample Request and Response {#sample-request-and-response}

For a sample request and response of this API, see [Get Display Names for Security Domains](https://developer.mastercard.com/riskrecon-api/documentation/testing/displaynames-samples/sec-dom-disp-nms-smpl/index.md).

## Use Case Example {#use-case-example}

The [Integrating the display names on your portal](https://developer.mastercard.com/riskrecon-api/documentation/use-cases/navigation-and-access/displayname/rtreve-disp-nm-sec-dom/index.md#integrating-the-display-names-on-your-portal) use case discusses how you can use the `GET Security Domain Display Names` endpoint to retrieve the display names of the security domain pages.

### Integrating the display names on your portal {#integrating-the-display-names-on-your-portal}

A RiskRecon customer wants to view the security domain ratings of its vendor on the RiskRecon web portal and display these ratings on an application running on their organization's portal. The customer can use the `GET Security Domain Display Names` to retrieve the display names of the security domains and map them to the application.
