Add a Gift Aid Declaration
You can add a new Gift Aid Declaration to an existing constituent using a POST request.
Send a POST request to:
https://data.donorfy.com/api/v1/<apikey>/constituents/{constituentid}/GiftAidDeclarationsInclude the required declaration details in the request body.
The request body must include:
A valid Declaration Method.
Declaration date, state, and end date.
Taxpayer first name and last name, each up to 35 characters.
If you include a campaign or department, the value must already exist in Donorfy.
Retrieve Gift Aid Declarations
You can retrieve all Gift Aid Declarations for a constituent using a GET request.
Send a GET request to:
https://data.donorfy.com/api/v1/<apikey>/constituents/{constituentid}/GiftAidDeclarationReview the list of returned declarations.
Filter by Date Range
You can limit results by declaration dates:
https://data.donorfy.com/api/v1/<apikey>/constituents/{constituentid}/GiftAidDeclarations?decStartDate=2010-01-01&decEndDate=2018-01-01
Add decStartDate and decEndDate query parameters.
Use dates in
YYYY-MM-DDformat.
Date filtering helps when auditing declarations over a specific period.
Update a Gift Aid Declaration
Existing Gift Aid Declarations can be updated using a PUT request.
Send a PUT request to:
https://data.donorfy.com/api/v1/<apikey>/constituents/{constituentid}/GiftAidDeclarationsInclude only the properties you want to change.
Properties not included in the request remain unchanged.
Cancel a Gift Aid Declaration
You can cancel an active Gift Aid Declaration using a dedicated endpoint.
Confirm the request completes successfully.
Cancelling a declaration:
Sets the cancellation date to the current system date.
Marks the declaration as cancelled in Donorfy.
Cancelled declarations are retained for audit purposes and are not deleted.
Understand Validation Rules
Gift Aid Declaration requests must meet Donorfy validation requirements.
Declaration methods must be valid.
Campaign and department values must exist in Donorfy.
Name fields must not exceed character limits.
Invalid values cause the request to fail or the affected property to be ignored.
⚠️Important:
The Donorfy API is a Professional-only feature. Essential subscribers, please contact us to find out more about upgrading.