# Get Real Cards
source: https://developer.mastercard.com/iccp/documentation/api-reference/soap_api/configuration-details/getrealcards/index.md

> Get all active real card aliases and IDs to use to create purchase requests. A real card alias defines the billing card for a payment.

## Parameter {#parameter}

|    Name     |                     Description                     | Required |     Type      |
|-------------|-----------------------------------------------------|----------|---------------|
| `companyId` | The ID of your company, up to 22 character maximum. | Yes      | Integer, long |

### Sample request {#sample-request}

```xml
<soapenv:Envelope
	xmlns:ser="http://mastercard.com/sd/pc/service"
	xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
	<soapenv:Header></soapenv:Header>
	<soapenv:Body>
		<ser:getRealCardsRequest>
			<ser:companyId>427521</ser:companyId>
		</ser:getRealCardsRequest>
	</soapenv:Body>
</soapenv:Envelope>
```

## Response {#response}

### RCNData Elements {#rcndata-elements}

|           Name            | Required (ICCP and ICMP) |                                                                                        Description                                                                                        | Required |     Type     |
|---------------------------|--------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------|--------------|
| `rcnId`                   | Y                        | * The ID of the real card number (RCN). Obtained by calling getRealCards. * Maximum length: 22 digits                                                                                     | Yes      | Numeric      |
| `rcnAlias`                | Y                        | * The user defined alias of the real card * Maximum length: 100 characters.                                                                                                               | Yes      | Alphanumeric |
| `clearingControlsEnabled` | N                        | * Indicator to show if Clearing Controls will be applied on Virtual Cards created using the Real Card. * Included in the response only when Clearing Controls is enabled for the company. | No       | Boolean      |

### Sample Response {#sample-response}

```xml
<?xml version="1.0" encoding="UTF-8"?>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
  <soapenv:Body>
    <getRealCardsResponse xmlns="http://mastercard.com/sd/pc/service" xmlns:ns2="http://mastercard.com/sd/pc2/service">
      <rcn>
        <rcnId>13800</rcnId>
        <rcnAlias>Sandbox Card</rcnAlias>
        <clearingControlsEnabled>Y</clearingControlsEnabled>
      </rcn>
      <rcn>
        <rcnId>13810</rcnId>
        <rcnAlias>Testing Card</rcnAlias>
        <clearingControlsEnabled>N</clearingControlsEnabled>
      </rcn>
      <errorMessage xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/>
    </getRealCardsResponse>
  </soapenv:Body>
</soapenv:Envelope>
```