> ## Documentation Index
> Fetch the complete documentation index at: https://docs.grailpay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Manage Refunds

Managing refunds is a critical part of the ACH lifecycle — especially when it comes to reconciling financial activity,
handling customer requests, and maintaining audit trails. The GrailPay Payments API provides a suite of endpoints to help
you **retrieve and review refund activity** across different levels of granularity: from batch summaries to individual
refund records.

Whether you're building a dashboard, troubleshooting a specific case, or simply auditing past refund activity, these
endpoints give you the visibility and flexibility you need to stay on top of refund flows.

***

## Available Actions

GrailPay currently supports the following operations for managing refunds:

* Retrieve details of a **specific batch refund**
* List **all batch refunds** with support for filtering and pagination
* Fetch **all refunds associated with a specific transaction**
* Retrieve **details about a specific refund**

***

## Retrieve a Batch Refund

You can retrieve a **specific batch refund** by using its unique UUID. This endpoint returns all key information for the
batch — including refund amount, status, processing timestamps, and linked transactions. This is useful when auditing or
reviewing the outcome of a large-scale reversal.

For full details, refer to our OpenAPI documentation:

* [Get Batch Refund](https://api.grailpay.com/api/documentation#/Refunds/63ed85c2621b265ccf4b9a5c4b4ec278)

***

## List All Batch Refunds

This endpoint allows you to fetch **a list of all batch refunds**, with support for filtering by status, date range,
and more. Results are paginated to support large datasets and can be sorted to help you find recent activity quickly.

This is ideal for:

* Reconciling large volumes of refund activity
* Exporting historical refund records
* Powering internal reporting dashboards

For full details, refer to our OpenAPI documentation:

* [List Batch Refunds](https://api.grailpay.com/api/documentation#/Refunds/83fd1801d91a8efd53e356094515a475)

***

## List Refunds

To retrieve a list of refunds, use this endpoint to return all refund records associated with your account. This
endpoint supports a rich set of query parameter filters, allowing you to refine results by transaction, merchant,
status, amount, date range, ACH trace ID, and return code. Results are paginated and can be sorted by created date
or amount.

This is especially useful for:

* Reconciling refunds across multiple transactions
* Tracking partial or multi-stage refund workflows
* Auditing refund history for a specific merchant or transaction
* Monitoring refund statuses and ACH return codes

For full request and response schemas, including available filters, refer to the
[List Refunds OpenAPI Documentation](https://api.grailpay.com/api/documentation#/Refunds/15ab8fb241a8a4e20e23f07b09932965).

***

## Retrieve a Specific Refund

Use this endpoint to fetch a **single refund by its UUID**, giving you detailed insight into a specific refund’s amount,
status, related transaction, and any associated batch.

This is useful for:

* Troubleshooting issues with a specific refund
* Confirming refund success
* Displaying granular refund data in product interfaces

For full details, refer to our OpenAPI documentation:

* [Fetch a Refund](https://api.grailpay.com/api/documentation#/Refunds/fc4444653bc3cccf783d03b44d81124d)

***

## Questions?

If you're encountering any issues, please reach out to [support@grailpay.com](mailto:support@grailpay.com).

***