# Get Real Cards
source: https://developer.mastercard.com/iccp/documentation/05_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 |

### 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>
      </rcn>
      <errorMessage
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/>
    </getRealCardsResponse>
  </soapenv:Body>
</soapenv:Envelope>
```

