<!--
{
  "availability" : [
    "App Store Server API: 1.1.0 - 1.6.0"
  ],
  "documentType" : "symbol",
  "framework" : "AppStoreServerAPI",
  "identifier" : "/documentation/AppStoreServerAPI/Get-Refund-History-V1",
  "metadataVersion" : "0.1.0",
  "role" : "Web Service Endpoint",
  "symbol" : {
    "kind" : "Web Service Endpoint",
    "modules" : [
      "App Store Server API"
    ],
    "preciseIdentifier" : "rest:app_store_server_api:get:v1-refund-lookup-{}"
  },
  "title" : "Get Refund History V1"
}
-->

# Get Refund History V1

Get a list of up to 50 of a customer’s refunded in-app purchases for your app.

## Discussion

Call this endpoint to get a customer’s refund history for your app. The response ([`RefundLookupResponse`](/documentation/AppStoreServerAPI/RefundLookupResponse)) includes up to 50 of the customer’s most-recently refunded transactions, based on the [`revocationDate`](/documentation/AppStoreServerAPI/revocationDate).

> Note:
> To get the complete refund history, use ``doc://com.apple.appstoreserverapi/documentation/AppStoreServerAPI/Get-Refund-History``.

To call this endpoint, provide any original transaction identifier (<doc://com.apple.documentation/documentation/StoreKit/Transaction/originalID>) for any of the customer’s in-app purchases. The response only includes App Store-approved refunds for any product type: consumable, non-consumable, auto-renewable subscriptions, and non-renewing subscriptions. For more information about product types, see [In-app purchase](https://developer.apple.com/in-app-purchase/).

The information in the response is the same as the information in one or more `REFUND` notifications (<doc://com.apple.documentation/documentation/AppStoreServerNotifications/notificationType>) from <doc://com.apple.documentation/documentation/AppStoreServerNotifications>. Use this API to retrieve any refund notifications you may have missed, such as during a server outage.

A successful response may have an empty `signedTransactions` array if the customer hasn’t received any App Store-approved refunds. To identify the date and reason code for a refund, see `revocationDate` and `revocationReason` in the [`JWSTransactionDecodedPayload`](/documentation/AppStoreServerAPI/JWSTransactionDecodedPayload).

The App Store Server API returns information based on the customer’s in-app purchase history regardless of whether the customer installs, removes, or reinstalls the app on their devices.

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)