The following operations are supported. For a formal definition, please review the Service Description.

• addCharityToTribute
  Please supply the following fields:
  

  Parameter	Type	Mandatory	Default	Description
  api_key	string	Mandatory		Your unique code to access this operation.
  user_id	int	Mandatory		The Memory Giving User ID of the person performing this operation.
  tribute_id	int	Mandatory		Unique ID that identifies each fund page.
  charity_ids	string	Mandatory		Comma separated charity IDs

• calculateGiftAidValue
  Please supply the following fields:
  

  Parameter	Type	Mandatory	Default	Description
  api_key	string	Mandatory		Your unique code to access this operation.
  donation	double	Mandatory		Donation amount in GBP.
  charity_id	int	Mandatory		Unique ID that identifies each charity.

• createTributePage
  Please supply the following fields:
  

  Parameter	Type	Mandatory	Default	Description
  api_key	string	Mandatory		Your unique code to access this operation.
  user_id	int	Mandatory		The Memory Giving User ID of the person performing this operation.
  charity_ids	string	Optional		Comma separated charity IDs. * Mandatory if Funeral Director field page_beneficiary_optional has a value of false.
  name	string	Mandatory		Full name of deceased.
  aliases	string	Optional		Other names that the deceased was known by.
  page_name	string	Optional		Automatically calculated from name parameter when creating tribute page.
  sex	string	Mandatory		Sex of deceased. Must be one of the following: MFMaleFemale * Currently Optional to allow integration of new field.
  date_of_birth	DateTime	Optional		(dd MMMM yyyy, dd MMM yyyy)
  date_of_death	DateTime	Mandatory		(dd MMMM yyyy, dd MMM yyyy)
  dod_msg_format	string	Optional		eg. Passed away on {0}{1}. {0} will be replaced with the date_of_death. {1} will be replaced with the age if date_of_birth is supplied.
  facebook_link	string	Optional		Page name of a tribute page set up on facebook.
  message	string	Optional		A message from the family or to the donors.
  beneficiary_note	string	Optional		A message from the family to the beneficiary about the allocation of funds.
  service_display	bool	Optional	false	If you specify a service_display parameter with a value of true, you must also specify service_date_time & service_address parameters.
  service_date_time	DateTime	Optional		* Mandatory if service_display is supplied as true. (dd MMMM yyyy HH:mm:ss, dd MMM yyyy HH:mm:ss)
  service_chapel	string	Optional		Name of the chapel where the service is held.
  service_address	string	Optional		* Mandatory if service_display is supplied as true. Address of where the service is held.
  service_location	string	Optional		Google Maps Decimal Degrees Format ([-90 - 90], [-180 - 180]). If omitted, this field will be automatically calculated from service_address.
  service_notes	string	Optional		Miscellaneous information related to the funeral.
  committal_display	bool	Optional	false	If you specify a committal_display parameter with a value of true, you must also specify committal_address parameters.
  committal_address	string	Optional		* Mandatory if service_display & committal_display are supplied as true. Address of where the committal is held.
  committal_location	string	Optional		Google Maps Decimal Degrees Format ([-90 - 90], [-180 - 180]). If omitted, this field will be automatically calculated from committal_address.
  reception_display	bool	Optional	false	If you specify a reception_display parameter with a value of true, you must also specify reception_date_time & reception_address parameters.
  reception_date_time	DateTime	Optional		* Mandatory if service_display & reception_display are supplied as true. (dd MMMM yyyy HH:mm:ss, dd MMM yyyy HH:mm:ss)
  reception_address	string	Optional		* Mandatory if service_display & reception_display are supplied as true. Address of where the reception is held.
  reception_location	string	Optional		Google Maps Decimal Degrees Format ([-90 - 90], [-180 - 180]). If omitted, this field will be automatically calculated from reception_address.
  t_address1	string	Optional		Deceased address line 1.
  t_address2	string	Optional		Deceased address line 2.
  t_town	string	Optional		Deceased address town.
  t_post_code	string	Optional		Deceased address post code.
  contact_name	string	Optional		* Mandatory if charity_id supplied. Contact / NOK name.
  contact_relationship	string	Optional	Other	* Mandatory if charity_id supplied. Contact / NOK relationship - must be one of the following: HusbandWifePartnerFatherMotherSonDaughterBrotherSisterGrandsonGranddaughterUncleAuntCousinNephewNieceFriendOther
  contact_email	string	Optional		* Mandatory if charity_id supplied. Contact / NOK email address.
  contact_address1	string	Optional		* Mandatory if charity_id supplied. Contact / NOK address line 1.
  contact_address2	string	Optional		Contact / NOK address line 2.
  contact_town	string	Optional		* Mandatory if charity_id supplied. Contact / NOK address town.
  contact_overseas	bool	Optional	false	Contact / NOK address is overseas.
  contact_post_code	string	Optional		* Mandatory if charity_id supplied & contact_overseas is false. Contact / NOK address post code.
  beneficiary_nok_details	bool	Optional	false	Indicates whether or not the contact / NOK grants the beneficiary access to their information for the purposes of a thank you letter.
  enabled	bool	Mandatory		Indicates whether the page is active or not.
  base64FileBytes	string	Optional		Base64 encoded string of the image file bytes. If you specify a base64FileBytes parameter, you must also specify a file_name parameter.
  file_name	string	Optional		File name, including extension, of the uploaded image.
  photo_width	int	Optional	200	Width in pixels that the source image should be reduced to.
  photo_top	int	Optional	0	Y coordinate of the source image in relation to the crop area.
  photo_left	int	Optional	0	X coordinate of the source image in relation to the crop area.
  photo_thumb_width	int	Optional	50	Width in pixels that the source image should be reduced to.
  photo_thumb_top	int	Optional	0	Y coordinate of the source image in relation to the crop area.
  photo_thumb_left	int	Optional	0	X coordinate of the source image in relation to the crop area.
  View Photo Crop Example

• getGiftAidDeclaration
  Please supply the following fields:
  

  Parameter	Type	Mandatory	Default	Description
  api_key	string	Mandatory		Your unique code to access this operation.

• getRecentlyUpdatedCharities
  Please supply the following fields:
  

  Parameter	Type	Mandatory	Default	Description
  api_key	string	Mandatory		Your unique code to access this operation.
  datetime	DateTime	Optional	current datetime	The date & time that forms the end range of the results to be returned.
  days	int	Optional		The number of days prior to the datetime that forms the start range of the results to be returned.
  page_number	int	Optional	1	The page number of the results to be returned. Must be used with a valid page_size.
  page_size	int	Optional	all results	The number of results returned for each page.

• isTributePageNameAvailable
  Please supply the following fields:
  

  Parameter	Type	Mandatory	Default	Description
  api_key	string	Mandatory		Your unique code to access this operation.
  page_name	string	Mandatory		Page name to compare to existing page names.

• loadTributeById
  Please supply the following fields:
  

  Parameter	Type	Mandatory	Default	Description
  api_key	string	Mandatory		Your unique code to access this operation.
  tribute_id	int	Mandatory		Unique ID that identifies each fund page.

• loadTributeGroupById
  Please supply the following fields:
  

  Parameter	Type	Mandatory	Default	Description
  api_key	string	Mandatory		Your unique code to access this operation.
  tribute_group_id	int	Mandatory		Unique ID that identifies each fund page group.

• makeDonation
  Please supply the following fields:
  

  Parameter	Type	Mandatory	Default	Description
  api_key	string	Mandatory		Your unique code to access this operation.
  user_id	int	Optional		* Mandatory if donation_online is false. The Memory Giving User ID of the person performing this operation.
  tribute_id	int	Mandatory		Unique ID that identifies each fund page.
  donation_online	bool	Optional	true	Indicates whether or not this donation has been made online or offline. Online donations will need to be processed by WordPay in order to appear in the list of donations.
  anonymous	bool	Optional	false	Indicates whether or not the donor details appear anonymously on fund page.
  anonymous_report	bool	Optional	false	Indicates whether or not the donor details appear anonymously within closed reports to next of kin, funeral director & charity.
  display_name	string	Mandatory		The name displayed when anonymous is supplied as false. Usually the donors name, but can be used to describe a group of donors e.g. Smith family.
  message	string	Optional		A message from the donor to the deceased or the deceased’s family. When anonymous is supplied as true, message will be hidden on fund page. When anonymous_report is supplied as true, message will be hidden in reports to NOK.
  email	string	Optional		* Mandatory if donation_online is true. Donor email address.
  ip	string	Optional		* Mandatory if donation_online is true. Donor IP address. Used with WorldPay as a security measure against fraudulent transactions.
  donation	double	Mandatory		Donation amount in GBP.
  hide_donation_value	bool	Optional	false	Indicates whether or not the donation value should be hidden.
  gift_aid	bool	Optional	false	* Mandatory if donation_online is true. If you specify this parameter with a value of true, you must also specify the first_name, last_name, address1, town & post_code parameters.
  first_name	string	Optional		* Mandatory if gift_aid is true. Donor first name.
  last_name	string	Optional		* Mandatory if gift_aid is true. Donor last name.
  address1	string	Optional		* Mandatory if gift_aid is true. Donor address line 1.
  address2	string	Optional		Donor address line 2.
  town	string	Optional		* Mandatory if gift_aid is true. Donor address town.
  overseas	bool	Optional	false	If you omit this parameter or specify it with a value of false, you must also specify the post_code parameter.
  post_code	string	Optional		* Mandatory if gift_aid is true & overseas is false. Donor address post code.
  payment_type	string	Optional		* Mandatory if donation_online is true. Must be one of the following: MASTERCARD_CREDIT - MasterCard CreditMASTERCARD_DEBIT - MasterCard DebitVISA_CREDIT - Visa CreditVISA_DEBIT - Visa Debit
  accept_t_c	bool	Optional	false	* Mandatory if donation_online is true. Indicates whether the donor has accepted the terms & conditions. This value must be true in order to submit a donation.
  successfulReturnURL	string	Optional		The return URL from WorldPay Payment site after a successful transaction. Must include the scheme, eg. http:// . If you omit this parameter, the return url will be the Memory Giving fund page url. Only applicable to online donations.
  unsuccessfulReturnURL	string	Optional		The return URL from WorldPay Payment site after an unsuccessful transaction. Must include the scheme, eg. http:// .If you omit this parameter, the return url will be the same as the successfulReturnURL. Only applicable to online donations.

• removeCharityFromTribute
  Please supply the following fields:
  

  Parameter	Type	Mandatory	Default	Description
  api_key	string	Mandatory		Your unique code to access this operation.
  user_id	int	Mandatory		The Memory Giving User ID of the person performing this operation.
  tribute_id	int	Mandatory		Unique ID that identifies each fund page.
  charity_ids	string	Mandatory		Comma separated charity IDs

• removeDonation
  Please supply the following fields:
  

  Parameter	Type	Mandatory	Default	Description
  api_key	string	Mandatory		Your unique code to access this operation.
  user_id	int	Mandatory		The Memory Giving User ID of the person performing this operation.
  donation_id	int	Mandatory		Unique ID that identifies each donation.

• search
  Please supply the following fields:
  

  Parameter	Type	Mandatory	Default	Description
  api_key	string	Mandatory		Your unique code to access this operation.
  deceased_name	string	Optional		Deceased name or fund page ID.
  funeral_director	string	Optional		Funeral Director name or ID.
  charity	string	Optional		Charity name or ID.
  show_open	bool	Optional	true	Filter search results to show open fund pages.
  show_closed	bool	Optional	false	Filter search results to show closed fund pages.
  scope_narrow	bool	Optional	false	When the value of the funeral_director parameter is supplied as the Funeral Director ID, the search results will also include other less relevant results that belong to the supplied Funeral Director. By supplying a value of true, only relevant matches for the Funeral Director will be returned.
  include_non_tribute_pages	bool	Optional	false	When the supplied value is true, the search results will also include tribute pages that are not associated with any charities.
  date_limit	DateTime	Optional	5 years before current datetime	Limits search results to pages created after the supplied date. (dd MMMM yyyy HH:mm:ss, dd MMM yyyy HH:mm:ss)

• searchCharities
  Please supply the following fields:
  

  Parameter	Type	Mandatory	Default	Description
  api_key	string	Mandatory		Your unique code to access this operation.
  charity_name	string	Mandatory		Name of the charity to search.

• suggestCharity
  Please supply the following fields:
  

  Parameter	Type	Mandatory	Default	Description
  api_key	string	Mandatory		Your unique code to access this operation.
  user_id	int	Mandatory		The Memory Giving User ID of the person performing this operation.
  charity_name	string	Mandatory		Name of the suggested charity.
  charity_number	string	Optional		Charity number of the suggested charity.

• updateDonation
  Please supply the following fields:
  

  Parameter	Type	Mandatory	Default	Description
  api_key	string	Mandatory		Your unique code to access this operation.
  user_id	int	Mandatory		The Memory Giving User ID of the person performing this operation.
  donation_id	int	Mandatory		Unique ID that identifies each donation.
  display_name	string	Mandatory		The name displayed when anonymous is supplied as false. Usually the donors name, but can be used to describe a group of donors e.g. Smith family.
  hide_donation_value	bool	Optional	false	* Only applicable to offline donations. Indicates whether or not the donation value should be hidden.
  anonymous	bool	Optional	false	* Only applicable to offline donations. Indicates whether or not this donation should be made anonymously.
  anonymous_report	bool	Optional	false	* Only applicable to offline donations. Indicates whether or not the donor details appear anonymously within closed reports to next of kin, funeral director & charity. Only applicable to offline donations.
  message	string	Optional		A message from the donor to the deceased or the deceased’s family when anonymous is supplied as false.

• updateTributePage
  Please supply the following fields:
  

  Parameter	Type	Mandatory	Default	Description
  api_key	string	Mandatory		Your unique code to access this operation.
  user_id	int	Mandatory		The Memory Giving User ID of the person performing this operation.
  tribute_id	int	Mandatory		Unique ID that identifies each fund page.
  charity_id	string	Optional		Unique ID that identifies each charity. * Mandatory if Funeral Director field page_beneficiary_optional has a value of false.
  name	string	Mandatory		Full name of deceased.
  aliases	string	Optional		Other names that the deceased was known by.
  page_name	string	Optional		Automatically calculated from name parameter when creating tribute page.
  sex	string	Mandatory		Sex of deceased. Must be one of the following: MFMaleFemale * Currently Optional to allow integration of new field.
  date_of_birth	DateTime	Optional		(dd MMMM yyyy, dd MMM yyyy)
  date_of_death	DateTime	Mandatory		(dd MMMM yyyy, dd MMM yyyy)
  dod_msg_format	string	Optional		eg. Passed away on {0}{1}. {0} will be replaced with the date_of_death. {1} will be replaced with the age if date_of_birth is supplied.
  facebook_link	string	Optional		Page name of a tribute page set up on facebook.
  message	string	Optional		A message from the family or to the donors.
  beneficiary_note	string	Optional		A message from the family to the beneficiary about the allocation of funds.
  service_display	bool	Optional	false	If you specify a service_display parameter with a value of true, you must also specify service_date_time & service_address parameters.
  service_date_time	DateTime	Optional		* Mandatory if service_display is supplied as true. (dd MMMM yyyy HH:mm:ss, dd MMM yyyy HH:mm:ss)
  service_chapel	string	Optional		Name of the chapel where the service is held.
  service_address	string	Optional		* Mandatory if service_display is supplied as true. Address of where the service is held.
  service_location	string	Optional		Google Maps Decimal Degrees Format ([-90 - 90], [-180 - 180]). If omitted, this field will be automatically calculated from service_address.
  service_notes	string	Optional		Miscellaneous information related to the funeral.
  committal_display	bool	Optional	false	If you specify a committal_display parameter with a value of true, you must also specify committal_address parameters.
  committal_address	string	Optional		* Mandatory if service_display & committal_display are supplied as true. Address of where the committal is held.
  committal_location	string	Optional		Google Maps Decimal Degrees Format ([-90 - 90], [-180 - 180]). If omitted, this field will be automatically calculated from committal_address.
  reception_display	bool	Optional	false	If you specify a reception_display parameter with a value of true, you must also specify reception_date_time & reception_address parameters.
  reception_date_time	DateTime	Optional		* Mandatory if service_display & reception_display are supplied as true. (dd MMMM yyyy HH:mm:ss, dd MMM yyyy HH:mm:ss)
  reception_address	string	Optional		* Mandatory if service_display & reception_display are supplied as true. Address of where the reception is held.
  reception_location	string	Optional		Google Maps Decimal Degrees Format ([-90 - 90], [-180 - 180]). If omitted, this field will be automatically calculated from reception_address.
  t_address1	string	Optional		Deceased address line 1.
  t_address2	string	Optional		Deceased address line 2.
  t_town	string	Optional		Deceased address town.
  t_post_code	string	Optional		Deceased address post code.
  contact_name	string	Optional		* Mandatory if charity_id supplied. Contact / NOK name.
  contact_relationship	string	Optional	Other	* Mandatory if charity_id supplied. Contact / NOK relationship - must be one of the following: HusbandWifePartnerFatherMotherSonDaughterBrotherSisterGrandsonGranddaughterUncleAuntCousinNephewNieceFriendOther
  contact_email	string	Optional		* Mandatory if charity_id supplied. Contact / NOK email address.
  contact_address1	string	Optional		* Mandatory if charity_id supplied. Contact / NOK address line 1.
  contact_address2	string	Optional		Contact / NOK address line 2.
  contact_town	string	Optional		* Mandatory if charity_id supplied. Contact / NOK address town.
  contact_overseas	bool	Optional	false	Contact / NOK address is overseas.
  contact_post_code	string	Optional		* Mandatory if charity_id supplied & contact_overseas is false. Contact / NOK address post code.
  beneficiary_nok_details	bool	Optional	false	Indicates whether or not the contact / NOK grants the beneficiary access to their information for the purposes of a thank you letter.
  enabled	bool	Mandatory		Indicates whether the page is active or not.
  base64FileBytes	string	Optional		Base64 encoded string of the image file bytes. If you specify a base64FileBytes parameter, you must also specify a file_name parameter.
  file_name	string	Optional		File name, including extension, of the uploaded image.
  photo_width	int	Optional	200	Width in pixels that the source image should be reduced to.
  photo_top	int	Optional	0	Y coordinate of the source image in relation to the crop area.
  photo_left	int	Optional	0	X coordinate of the source image in relation to the crop area.
  photo_thumb_width	int	Optional	50	Width in pixels that the source image should be reduced to.
  photo_thumb_top	int	Optional	0	Y coordinate of the source image in relation to the crop area.
  photo_thumb_left	int	Optional	0	X coordinate of the source image in relation to the crop area.
  View Photo Crop Example