Get Gift Certificate Details

NOTE: You must enter sign the terms of service agreement with GlobalGiving to use this API feature. Please download, sign and email a copy of the terms of service agreement here, and return to api@globalgiving.org to enable this feature. You must certify that you will handle donor input and data in compliance with PCI-DSS standards when handling sensitive information. Mainly this means ensuring your connections are HTTPS, your servers are secure, and you never store a users creditcard information.

This operation allows a user to query the validity and details of a gift certificate.

HTTP Method:

GET

Content Type:

xml, json

Accept Type:

xml, json

Path:

https://api.globalgiving.org/api/secure/givingservice/giftcertificatedetail/{giftcertid}/

Path Parameters:

giftcertid The giftcertificate number to check, required

Query String Parameters:

&api_key described in the API Key section, required

Query String Example:

/api/secure/givingservice/giftcertificatedetail/GXYZ12345678?api_key=YOUR_API_KEY

Data Parameters:

None

HTTP Get Request Example, using cURL

curl -H "Accept: application/xml" -H "Content-Type: application/xml"
 -X GET "https://api.globalgiving.org/api/secure/givingservice/giftcertificatedetail/GXYZ123456789?api_key=YOUR_API_KEY"

NOTE: Above request has carriage returns for readability.

XML Response:

<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<giftCertificate_detail>
   <currencyCode>USD</currencyCode>
   <expirationDate>2020-12-31T23:59:59-04:00</expirationDate>
   <giftCertificateNumber>GZTKACJEA0Q46</giftCertificateNumber>
   <remainingAmount>25.00</remainingAmount>
   <valid>true</valid>
</giftCertificate_detail>

Get Gift Certificate Detail Response Structure

giftCertificate_detail

currencyCode	string
expirationDate	dateTime
giftCertificateNumber	string
remainingAmount	decimal
valid	boolean

Element Definitions for Get Gift Certificate Detail Response

Element	Mandatory	Description
currencyCode	required	The currency the Gift Certificate amount is in.
expirationDate	required	The date of expiration - the giftcertificate is good through the expiration date in Eastern US time-zone.
giftCertificateNumber	required	Will be the same giftcertid passed into the query.
remainingAmount	required	Amount of funds remaining on the gift certificate.
valid	required	Quick way to determine if certificate is valid. This is false if the cert has been invalidated by a system administrator, or if the expirationDate is in the past, or if the remainingBalance is