💫 Personal Fundraising Pages

Personal Fundraising Pages created on the Fundraising Platform can be created to fundraise towards a charity, a fundraising event or as part of a team of fundraisers.

Each page will be created with a unique ID 'pfID'.

The following table contains the fields that are returned within the response call of the personal fundraising page endpoint.

Key	Label	Type	Description
supporterId	Supporter Id	Long	Supporter Id
companyId	Company Id	Long	Company Id
charityId	Charity Id	Long	Charity Id
charityAccountGuid	Charity Account Guid	UUID	Charity Account GUID
companyAccountGuid	Company Account Guid	UUID	Company Account GUID
campaignGuid	Campaign Guid	UUID	Campaign Guid
displayName	Registrant Name	String	Registrant Name
title	Title	String	Personal fundraising page title
raisedAmount	Raised Amount	Long	Total amount raised
offlineDonationsTotal	Offline Donations Total	Long	Total amount raised offline
giftAidRaised	Gift Aid Raised	Long	Total amount of gift aid raised
createdDate	Created Date	Date	Date page was created
pageUrl	Page Url	String	Url of the page
pfId	Personal Fundraising ID	Long	Personal fundraising page Id
eventPageId	Event Page Id	Long	Event page Id
target	Target	Long	Target amount
status	Status	String	Status of the page, values can be: 0, open 1, closed
liveDate	Live Date	Date	Date page will be live
teamId	Team Id	Long	Team Id
lastUpdatedDate	Last Updated Date	Date	Date fundraising page was last updated

🚧
Reminder
If a supporterId is returned and has the value of 0. This is due to the fact a supporter was never created, which is caused by a fundraising page never having gone live

🚀 Returns a list of personal fundraising pages

/personalFundraisingPage

Get a list of personal fundraising pages filterable by the attributes below.

Key	Label	Type	Description
campaign_guids	Campaign Guids	Array[string]	Campaign GUID associated with the personal fundraising page
event_ids	Event Ids	Array[Long]	Event Ids associated with the personal fundraising page object
date_from	Date From	String	Date from which to filter based on the created date of the personal fundraising page
date_to	Date To	String	Date to filter to based on the created date of the personal fundraising page
new_personal_fundraising_pages_only	New Personal Fundraising Pages Only	Boolean	Used in conjunction with date filters, if set to true will filter using createdDate, otherwise will use both createdDate and lastUpdatedAt (defaults to false)
limit	Limit	Integer	Number of records to be returned in the response
page	Page	Integer	The number of pages to skip before starting to collect the result set

Sample Request

GET - http://dataapi.enthuse.com/personalFundraisingPage?access_token=rR5_kQN_TVZMwqz4tyc8vzJ0ltc
&campaign_guids=00000000-0000-0000-0000-000000000000
&date_from=2020-02-25%2000%3A00%3A00
&date_to=2020-03-01%2000%3A00%3A00
&limit=25
&page=1

Sample Responses

200 - OK call was successful and returned data

[
{
  "campaignGuid": "d290f1ee-6c54-4b01-90e6-d701748f0851",
  "charityAccountGuid": "d290f1ee-6c54-4b01-90e6-d701748f0851",
  "charityId": 7236487,
  "companyAccountGuid": "d290f1ee-6c54-4b01-90e6-d701748f0851",
  "companyId": 7236487,
  "createdDate": "2020-01-01 00:00:00",
  "displayName": "string",
  "eventPageId": 0,
  "giftAidRaised": 0,
  "liveDate": "2020-01-01 00:00:00",
  "pageUrl": "string",
  "pfId": 0,
  "raisedAmount": 0,
  "status": "string",
  "supporterId": 7236487,
  "target": 0,
  "teamId": 0,
  "title": "string",
  "totalOfflineDonations": 0
  "lastUpdatedData": "2022-05-17T12:00:00.0000000Z"
},
{
  "campaignGuid": "r490f2et-6c74-4b01-90e6-d701748f0851",
  "charityAccountGuid": "d290f1ee-6c54-4b01-90e6-d701748f0851",
  "charityId": 7236487,
  "companyAccountGuid": "d290f1ee-6c54-4b01-90e6-d701748f0851",
  "companyId": 7236487,
  "createdDate": "2021-01-01 00:00:00",
  "displayName": "string",
  "eventPageId": 0,
  "giftAidRaised": 0,
  "liveDate": "2020-11-01 00:00:00",
  "pageUrl": "string",
  "pfId": 1234,
  "raisedAmount": 10,
  "status": "string",
  "supporterId": 7236487,
  "target": 0,
  "teamId": 0,
  "title": "string",
  "totalOfflineDonations": 0
  "lastUpdatedData": "2022-05-17T12:00:00.0000000Z"
}
]

401 - Access token has expired or is incorrect

{
  "message": "Unauthorized.",
  "status": 401
}

403 - The account linked to the token does not match the account of the records attempting to retrieve

{
  "message": "Forbidden.",
  "status": 403
}

404 - Call authenticated but no records match the searched criteria

{
  "message": "No records found.",
  "status": 404
}

🚀 Retrieves an existing personal fundraising page record

/personalFundraisingPage/{pfId}

Get a personal fundraising page filterable by a known pfId below.

Key	Label	Type	Description
pfId	Personal Fundraising Page Id	String	Personal fundraising page Id

Sample Request

GET - http://dataapi.enthuse.com/personalFundraisingPage/123?access_token=rR5_kQN_TVZMwqz4tyc8vzJ0ltc

Sample Responses:

200 - OK call was successful and returned data

{
  "campaignGuid": "d290f1ee-6c54-4b01-90e6-d701748f0851",
  "charityAccountGuid": "d290f1ee-6c54-4b01-90e6-d701748f0851",
  "charityId": 7236487,
  "companyAccountGuid": "d290f1ee-6c54-4b01-90e6-d701748f0851",
  "companyId": 7236487,
  "createdDate": "2020-01-01 00:00:00",
  "displayName": "string",
  "eventPageId": 0,
  "giftAidRaised": 0,
  "liveDate": "2020-01-01 00:00:00",
  "pageUrl": "string",
  "pfId": 0,
  "raisedAmount": 0,
  "status": "string",
  "supporterId": 7236487,
  "target": 0,
  "teamId": 0,
  "title": "string",
  "totalOfflineDonations": 0
  "lastUpdatedData": "2022-05-17T12:00:00.0000000Z"
}

401 - Access token has expired or is incorrect

{
  "message": "Unauthorized.",
  "status": 401
}

403 - The account linked to the token does not match the records attempting to retrieve

{
  "message": "Forbidden.",
  "status": 403
}

404 - Call authenticated but no records match the searched criteria

{
  "message": "No records found.",
  "status": 404
}

500 - Error occurred within Service, data could not be returned

{
  "message": "Internal Server Error.",
  "status": 500
}

🚀 Search personal fundraising pages that have no linked campaign or event

/personalFundraisingPage/noCampaign

Get a list of personal fundraising pages with no linked campaign or event filterable by the attributes below.

Key	Label	Type	Description
date_from	Date From	String	Date from which to filter based on the created date of the personal fundraising page
date_to	Date To	String	Date to filter to based on the created date of the personal fundraising page
limit	Limit	Integer	Number of records to be returned in the response
page	Page	Integer	The number of pages to skip before starting to collect the result set

Sample Request

GET - http://dataapi.enthuse.com/personalFundraisingPage/noCampaign?access_token=rR5_kQN_TVZMwqz4tyc8vzJ0ltc
&date_from=2020-02-25%2000%3A00%3A00
&date_to=2020-03-01%2000%3A00%3A00
&limit=25
&page=1

Sample Responses:

200 - OK call was successful and returned data

{
  "campaignGuid": "d290f1ee-6c54-4b01-90e6-d701748f0851",
  "charityAccountGuid": "d290f1ee-6c54-4b01-90e6-d701748f0851",
  "charityId": 7236487,
  "companyAccountGuid": "d290f1ee-6c54-4b01-90e6-d701748f0851",
  "companyId": 7236487,
  "createdDate": "2020-01-01 00:00:00",
  "displayName": "string",
  "eventPageId": 0,
  "giftAidRaised": 0,
  "liveDate": "2020-01-01 00:00:00",
  "pageUrl": "string",
  "pfId": 0,
  "raisedAmount": 0,
  "status": "string",
  "supporterId": 7236487,
  "target": 0,
  "teamId": 0,
  "title": "string",
  "totalOfflineDonations": 0
  "lastUpdatedData": "2022-05-17T12:00:00.0000000Z"
}

401 - Access token has expired or is incorrect

{
  "message": "Unauthorized.",
  "status": 401
}

403 - The account linked to the token does not match the account of the records attempting to retrieve

{
  "message": "Forbidden.",
  "status": 403
}

404 - Call authenticated but no records match the searched criteria

{
  "message": "No records found.",
  "status": 404
}

500 - Error occurred within Service, data could not be returned

{
  "message": "Internal Server Error.",
  "status": 500
}