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

# List account refunds

> Use the /credit/accounts/{accounttoken}/refunds endpoint to retrieve an array of refunds on a credit account.

GET/credit/accounts/\{account\_token}/refunds

Use the `/credit/accounts/{account_token}/refunds` endpoint to retrieve an array of refunds on a credit account.

This endpoint supports [sorting and pagination](https://www.marqeta.com/docs/core-api/sorting-and-pagination.md).

## URL path parameters

| Fields | Description |
| - | - |
| account\_token string  Required | Unique identifier of the credit account for which to retrieve refunds. Send a `GET` request to `/credit/accounts` to retrieve existing credit account tokens. **Allowable Values:**  Existing account token |

## URL query parameters

| Fields | Description |
| - | - |
| start\_date date  Optional | Beginning of the date range of the refunds to return. **Allowable Values:**  Format: yyyy-MM-dd |
| end\_date date  Optional | End of the date range of the refunds to return. **Allowable Values:**  Format: yyyy-MM-dd |
| count integer  Optional | Number of account refund resources to retrieve. **Allowable Values:**  1–100 |
| start\_index integer  Optional | Sort order index of the first resource in the returned array. **Allowable Values:**  0 min |
| sort\_by string  Optional | Field on which to sort. Prefix the field name with a hyphen (`-`) to sort in descending order. Omit the hyphen to sort in ascending order. Only supports `lastModifiedTime` and `-lastModifiedTime`. **NOTE:** You must sort using system field names such as `lastModifiedTime`, and not by the field names appearing in response bodies such as `updated_time`. **Allowable Values:**  `lastModifiedTime`, `-lastModifiedTime` |
| statuses array of strings  Optional | Array of statuses by which to filter refunds. **Allowable Values:**  `INITIATED`, `PENDING`, `PROCESSING`, `SUBMITTED`, `CANCELLED`, `COMPLETED`, `RETURNED` |

## Response body

| Fields | Description |
| - | - |
| count integer  Returned | Number of resources returned. **Allowable Values:**  1-10 |
| start\_index integer  Returned | Sort order index of the first resource in the returned array. **Allowable Values:**  Any integer |
| end\_index integer  Returned | Sort order index of the last resource in the returned array. **Allowable Values:**  Any integer |
| is\_more boolean  Returned | A value of `true` indicates that more unreturned resources exist. **Allowable Values:**  `true`, `false` |
| data array of objects  Returned | Contains one or more refunds on a credit account. **Allowable Values:**  One or more refund objects |
| data\[].**token** string  Returned | Unique identifier of the refund. **Allowable Values:**  36 char max |
| data\[].**account\_token** string  Returned | Unique identifier of the account for which the refund is issued. **Allowable Values:**  36 char max  Existing account token |
| data\[].**status** string  Returned | Current status of the refund. **Allowable Values:**  `INITIATED`, `PENDING`, `PROCESSING`, `SUBMITTED`, `CANCELLED`, `COMPLETED`, `RETURNED` |
| data\[].**method** string  Returned | Payment instrument used to issue the refund. **Allowable Values:**  `ACH`, `CHECK` |
| data\[].**type** string  Returned | Type of refund. **Allowable Values:**  `PAYMENT_REFUND`, `CREDIT_BALANCE_REFUND` |
| data\[].**payment\_source\_token** string  Conditionally returned | Unique identifier of the payment source that receives the refunded amount. **Allowable Values:**  36 char max  Existing payment source token |
| data\[].**amount** decimal  Returned | Amount of the refund. The maximum refund amount is the amount that brings the account balance to \$0. For example, \$4000 is the maximum refund amount for a -\$4000 account balance. **Allowable Values:**  0.01 min |
| data\[].**currency\_code** string  Returned | Valid three-digit [ISO 4217 currency code](https://www.iso.org/iso-4217-currency-codes.html). **Allowable Values:**  `USD` |
| data\[].**description** string  Conditionally returned | Description of the refund. **Allowable Values:**  255 char max |
| data\[].**created\_time** datetime  Returned | Date and time when the refund was created. **Allowable Values:**  Format: yyyy-MM-ddThh:mm:ssZ |
| data\[].**updated\_time** datetime  Returned | Date and time when the refund was last updated. **Allowable Values:**  Format: yyyy-MM-ddThh:mm:ssZ |

## Sample response body

```json JSON expandable lines wrap theme={null}
{
  "count": 2,
  "start_index": 0,
  "end_index": 2,
  "is_more": false,
  "data": [
    {
      "token": "credit_balance_refund_token1234",
      "account_token": "my_account_token_12",
      "status": "PENDING",
      "method": "ACH",
      "type": "CREDIT_BALANCE_REFUND",
      "payment_source_token": "my_payment_funding_source_token",
      "amount": 10,
      "currency_code": "USD",
      "description": "credit balance refund",
      "created_time": "2025-01-02T20:17:28Z",
      "updated_time": "2025-01-02T20:17:28Z"
    },
    {
      "token": "credit_balance_refund_token12",
      "account_token": "my_account_token_34",
      "status": "COMPLETED",
      "method": "CHECK",
      "type": "CREDIT_BALANCE_REFUND",
      "amount": 10,
      "currency_code": "USD",
      "description": "credit balance refund",
      "created_time": "2025-01-02T20:17:28Z",
      "updated_time": "2025-01-02T20:17:28Z"
    }
  ]
}
```


## Related topics

- [Account Refunds Overview](https://www.marqeta.com/docs/core-api/credit-account-refunds.md)
- [List account payments](https://www.marqeta.com/docs/core-api/credit-account-payments/list-account-payments.md)
- [List account journal entries](https://www.marqeta.com/docs/core-api/credit-account-journal-entries/list-account-journal-entries.md)
- [List transactions for a funding account](https://www.marqeta.com/docs/core-api/transactions/list-funding-account.md)
- [Retrieve account refund](https://www.marqeta.com/docs/core-api/credit-account-refunds/retrieve-account-refund.md)