# Records Request
source: https://developer.mastercard.com/donations/documentation/parameters/records_request/index.md

|        Name         |  Type  |                                                                                  Description                                                                                   |    Notes     |
|---------------------|--------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------|
| **partner**         | object | An object representing the partner details. See [Partner](https://developer.mastercard.com/donations/documentation/parameters/records_request/index.md#partner) attributes.    | **Required** |
| **customer**        | object | An object representing the customer details. See [Customer](https://developer.mastercard.com/donations/documentation/parameters/records_request/index.md#customer) attributes. | Optional     |
| **merchant**        | object | An object representing the merchant details. See [Merchant](https://developer.mastercard.com/donations/documentation/parameters/records_request/index.md#merchant) attributes. | Optional     |
| **transactionDate** | string | The date and time associated with the transaction. Must be in `yyyy-MM-dd HH:mm:ss` format.                                                                                    | **Required** |
| **transactionId**   | string | The transaction's unique identifier.                                                                                                                                           | **Required** |
| **campaignId**      | string | The campaign's unique identifier                                                                                                                                               | Optional     |
| **currency**        | string | The currency name.                                                                                                                                                             | **Required** |
| **amount**          | string | The donation amount.                                                                                                                                                           | **Required** |
| **cardScheme**      | string | Card Scheme Name.                                                                                                                                                              | Optional     |
| **charityId**       | string | The charity's unique identifier.                                                                                                                                               | Optional     |
| **charityName**     | string | The charity's name.                                                                                                                                                            | **Required** |
| **donationType**    | string | The type of donation.                                                                                                                                                          | Optional     |

### Child Attributes {#child-attributes}

#### partner {#partner}

|        Name        |  Type  |                                                       Description                                                       |     Notes     |
|--------------------|--------|-------------------------------------------------------------------------------------------------------------------------|---------------|
| **partnerName**    | string | The Partner's name.                                                                                                     | **Required**  |
| **isoCountryCode** | string | The addresses country in three-character [ISO 3166-1 alpha-3](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3) format. | **Required**. |
| **locale**         | string | The Partner's preferred locale (languages).                                                                             | Optional      |

#### customer {#customer}

|        Name        |  Type  |                                                       Description                                                       |     Notes     |
|--------------------|--------|-------------------------------------------------------------------------------------------------------------------------|---------------|
| **customerName**   | string | The Customer's name.                                                                                                    | **Required**  |
| **isoCountryCode** | string | The addresses country in three-character [ISO 3166-1 alpha-3](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3) format. | **Required**. |
| **locale**         | string | The Customer's preferred locale (languages).                                                                            | Optional      |

#### merchant {#merchant}

|       Name       |  Type  |            Description            |  Notes   |
|------------------|--------|-----------------------------------|----------|
| **merchantId**   | string | The Merchant's unique identifier. | Optional |
| **merchantName** | string | The Merchant's name.              | Optional |