# Parameters to Add Multiple Cards
source: https://developer.mastercard.com/donations/documentation/parameters/manage-cards-param/add-bulk-cards-param/index.md

## Method to Add Bulk Cards-on-file {#method-to-add-bulk-cards-on-file}

| Method |                Endpoint                 |
|--------|-----------------------------------------|
| POST   | /donations/donors/{donor_id}/bulk-cards |

## 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                                                                                               |    Notes     |
|-----------------|--------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------|
| **cardDetails** | object | List of cards to be added for a donor. See [Card Details](https://developer.mastercard.com/donations/documentation/parameters/manage-cards-param/add-bulk-cards-param/index.md#cardDetails) attributes. | **Required** |

### cardDetails {#carddetails}

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

### Child Attributes {#child-attributes}

#### billingAddress {#billingaddress}

|      Name       |  Type  |                                                                                       Description                                                                                        |  Notes   |
|-----------------|--------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------|
| **line1**       | string | The type of address. Allowed values are : *home* , *work* and *others*                                                                                                                   | Optional |
| **line2**       | string | The donor's street address.                                                                                                                                                              | Optional |
| **line3**       | string | The donor's land mark or other address.                                                                                                                                                  | Optional |
| **city**        | string | City, district, suburb, town or village                                                                                                                                                  | Optional |
| **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) | Optional |
| **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.                                                       | Optional |

#### expiryInfo {#expiryinfo}

|   Name    |  Type  |                                                                                          Description                                                                                          |    Notes     |
|-----------|--------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------|
| **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). Minimum value: 01. Maximum value: 12. | **Required** |
| **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).                                                                 | **Required** |

## Response Parameters {#response-parameters}

A successful request returns an `HTTP 200 Create` status code along with a JSON response containing two lists:

* One for the cards that were successfully added
* Another for the cards that failed to be added, including the reason code for each failure.

|      Name       | Type  |                   Description                   |
|-----------------|-------|-------------------------------------------------|
| **addedCards**  | array | List of cards that were successfully added.     |
| **failedCards** | array | List of cards that were not successfully added. |

### Child Attributes {#child-attributes-1}

#### addedCards {#addedcards}

|      Name      |  Type  |                          Description                           |
|----------------|--------|----------------------------------------------------------------|
| **maskedCard** | string | The masked card number, showing the first 6 and last 4 digits. |
| **cardId**     | string | Unique ID for the card on file. Generated by Mastercard.       |

#### failedCards {#failedcards}

|      Name      |  Type  |                          Description                           |
|----------------|--------|----------------------------------------------------------------|
| **maskedCard** | string | The masked card number, showing the first 6 and last 4 digits. |
| **reasonCode** | string | The failure reason code.                                       |