# Parameters to Retrieve a Donor source: https://developer.mastercard.com/donations/documentation/parameters/enroll-manage-donor-param/get-donor-param/index.md ## Method to Retrieve a Donor {#method-to-retrieve-a-donor} | Method | Endpoint | |--------|-----------------------------| | GET | /donations/donors/{donorId} | ## Path Parameters {#path-parameters} | Parameter | Description | |-------------|-----------------------------------------------------------------| | **donorId** | Unique ID generated by Mastercard when a new donor is enrolled. | ## Response Parameters {#response-parameters} Note: The Entire Response Body is encrypted, it should be decrypted to view the actual response fields! For more details, refer to the [How to Decrypt](https://developer.mastercard.com/donations/tutorial/how-to-access-sandbox-environment/mastercard-encryption-decryption-mechanism/index.md) section. | Name | Description | |----------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **userName** | Email address of the donor | | **userType** | The type of donor based on how they were enrolled into your donations program. Options include **Partner** , **Batch** and **Online** | | **emails** | An object representing the donor's email addresses. See [Email](https://developer.mastercard.com/donations/documentation/parameters/enroll-manage-donor-param/get-donor-param/index.md#emails) attributes. | | **locale** | The donor's preferred locale (languages). | | **name** | An object representing the donor's name. See the [Name](https://developer.mastercard.com/donations/documentation/parameters/enroll-manage-donor-param/get-donor-param/index.md#name) attributes for details. | | **acceptedConsents** | An object representing the donor's legal consents. See [Accepted Consents](https://developer.mastercard.com/donations/documentation/parameters/enroll-manage-donor-param/get-donor-param/index.md#acceptedConsents) attributes. | | **addresses** | An object containing the physical address associated with the donor's profile. See the [Addresses](https://developer.mastercard.com/donations/documentation/parameters/enroll-manage-donor-param/get-donor-param/index.md#addresses) attributes. | | **timeZone** | The time zone associated with the donor's mailing address. Must be in [UTC time in ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format. | | **title** | The title used to address the name of the donor. For example *Miss/Mr/Mrs*. | | **phoneNumbers** | An object representing the donor's phone numbers. See the [Phone Numbers](https://developer.mastercard.com/donations/documentation/parameters/enroll-manage-donor-param/get-donor-param/index.md#phoneNumbers) attributes. | | **password** | The password chosen by the donor when enrolling in your donations program. If passwords are sent in API Request body, they are stored in a PCI-Compliant space mapped to the donorId. | ### Child Attributes {#child-attributes} #### emails {#emails} | Name | Type | Description | |-----------|--------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **value** | string | The email address format must comply with standard limitations, specifically ensuring that the local part (the portion before the '@' symbol) does not exceed 64 characters. Additionally, the total length of the email address, including the '@' symbol and the domain, must not exceed 250 characters. | | **type** | string | The type of email address. For example *work, home* | #### name {#name} | Name | Type | Description | |---------------------|--------|-----------------------------------------------------| | **firstName** | string | Donor's first name. Also known as given name. | | **lastName** | string | Donor's last name. Also known as family name. | | **honorificPrefix** | string | Prefix that is added in front of the donor's name. | | **honorificSuffix** | string | Suffix added after the donor's first and last name. | #### acceptedConsents {#acceptedconsents} | Name | Type | Description | |------------------------------|--------|-------------------------------------------------------------------------------------------------------------| | **tncVersion** | string | The version number of the terms and conditions the cardholder accepted to enroll in your donations program. | | **privacyNoticeVersion** | string | The version number of the privacy policy the cardholder accepted to enroll in your donations program. | | **marketingEmailSubscribed** | string | Indicates if the donor has opted in to receive marketing email messages from your donations service. | #### addresses {#addresses} | Name | Type | Description | |-------------------|--------|-------------------------------------------------------------------------------------------------------------------------| | **type** | string | The type of address. For example: *work, home etc* | | **formatted** | string | The donor's street address | | **streetAddress** | string | The donor's street address. | | **locality** | string | The city, district, suburb, town or village of the address. | | **region** | string | The donor's region. | | **postalCode** | string | The address's [postal code](https://en.wikipedia.org/wiki/Postal_code), which is the zip code or equivalent. | | **country** | string | The addresses country in three-character [ISO 3166-1 alpha-3](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3) format. | #### phoneNumbers {#phonenumbers} | Name | Type | Description | |-----------|--------|--------------------------------------------------------------| | **type** | string | The type of phone number. For example *work*, home, etc. | | **value** | string | The 11-digit phone number associated with the donor profile. |