Get Refunds
Get Refunds
Returns refunds for the authenticated nonprofit based on the provided filters.
Refund Status
PENDING: The refund request has been created and is awaiting processor completion.SUCCEEDED: The refund has completed successfully.FAILED: The refund failed at the processor or settlement layer.CANCELED: The refund was canceled before completion.REQUIRES_ACTION: Additional action is required before the refund can complete.
Refund Reasons
REQUESTED_BY_CUSTOMER: The donor requested the refund.FRAUDULENT: The refund was issued due to suspected fraud.DUPLICATE: The refund was issued for a duplicate charge.EXPIRED_OR_UNCAPTURED_CHARGE: The original charge expired or was not captured.
Filtering
- Use
contributionIdto return refunds for a specific contribution. - Use
minimumUpdatedDateandmaximumUpdatedDateto poll for refunds that changed within a specific window. - Results are sorted by
createdAt(ascending or descending viasortDirection) and paginated withlimitandpage.
All monetary amounts in the response are expressed in cents.
GET
Get Refunds
Authorizations
Client ID for API authentication
API Key for API authentication
Query Parameters
The number of refunds to return.
Required range:
1 <= x <= 100The page number of the refunds to return.
Required range:
x >= 1Sort direction by refund created date. Defaults to descending.
Available options:
ASC, DESC Example:
"DESC"
Filter by contribution id.
Pattern:
^[0-9a-fA-F]{24}$Example:
"8810f34fd5061afeec3eab68"
The minimum updated date of the refunds to return.
Example:
"2025-01-01"
The maximum updated date of the refunds to return.
Example:
"2025-02-01"
Last modified on July 14, 2026