# Parameters to Search a Card
source: https://developer.mastercard.com/donations/documentation/parameters/manage-cards-param/search-a-card-param/index.md

## Method to Search a Card {#method-to-search-a-card}

| Method |             Endpoint              |
|--------|-----------------------------------|
| POST   | /donors/{donor_id}/cards/searches |

## Path Parameters {#path-parameters}

|    Name     |  Type  |                           Description                           |
|-------------|--------|-----------------------------------------------------------------|
| **donorId** | string | Unique ID generated by Mastercard when a new donor is enrolled. |

## Request Parameters {#request-parameters}

Note: The Entire Request Body has to be encrypted! For more details, refer to the [How to Encrypt](https://developer.mastercard.com/donations/tutorial/how-to-access-sandbox-environment/mastercard-encryption-decryption-mechanism/index.md) section.

|           Name           |  Type  |                                Description                                 |
|--------------------------|--------|----------------------------------------------------------------------------|
| **primaryAccountNumber** | string | The primary account number (PAN) for the payment card. Maximum length: 19. |

## Response Parameters {#response-parameters}

|              Name              |  Type  |                                                                                                          Description                                                                                                           |
|--------------------------------|--------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **cardholderName**             | string | The card holder's name as it appears on the card.                                                                                                                                                                              |
| **primaryAccountNumber**       | string | The primary account number (PAN) for the payment card. Maximum length: 19.                                                                                                                                                     |
| **primaryAccountNumberSource** | string | The source.                                                                                                                                                                                                                    |
| **expiryInfo**                 | object | The expiry info. See [Expiry Info](https://developer.mastercard.com/donations/documentation/parameters/manage-cards-param/search-a-card-param/index.md#expiryInfo) attributes.                                                 |
| **billingAddress**             | object | An object representing the cardholder's billing address. See [Billing Address](https://developer.mastercard.com/donations/documentation/parameters/manage-cards-param/search-a-card-param/index.md#billingAddress) attributes. |
| **cardAlias**                  | string | The alias provided by the cardholder to identify the card. Maximum length: 40.                                                                                                                                                 |

### Child Attributes {#child-attributes}

#### expiryInfo {#expiryinfo}

|   Name    |  Type  |                                                                       Description                                                                       |
|-----------|--------|---------------------------------------------------------------------------------------------------------------------------------------------------------|
| **month** | string | The expiration month of the associated card as an integer between 1 and 12. in [Internet date format](https://tools.ietf.org/html/rfc3339#section-5.6). |
| **year**  | string | The four-digit year of the card's expiration date in [Internet date format](https://tools.ietf.org/html/rfc3339#section-5.6).                           |

#### billingAddress {#billingaddress}

|      Name       |  Type  |                                                                                       Description                                                                                        |  Notes   |
|-----------------|--------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------|
| **line1**       | string | The type of address. For example: *work, home etc*                                                                                                                                       |          |
| **line2**       | string | The donor's street address.                                                                                                                                                              |          |
| **line3**       | string | The donor's land mark or other address.                                                                                                                                                  | Optional |
| **city**        | string | City, district, suburb, town or village                                                                                                                                                  |          |
| **postalCode**  | string | The postal code, which is the zip code or equivalent. Typically required for countries with a postal code or an equivalent. See [Postal Code](https://en.wikipedia.org/wiki/Postal_code) |          |
| **countryCode** | string | Three-character [ISO 3166-1 alpha-3](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3) code that identifies the country or region.                                                       |          |