<!--
{
  "availability" : [
    "App Store Server API: 1.5.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "AppStoreServerAPI",
  "identifier" : "/documentation/AppStoreServerAPI/Get-Notification-History",
  "metadataVersion" : "0.1.0",
  "role" : "Web Service Endpoint",
  "symbol" : {
    "kind" : "Web Service Endpoint",
    "modules" : [
      "App Store Server API"
    ],
    "preciseIdentifier" : "rest:app_store_server_api:post:v1-notifications-history"
  },
  "title" : "Get Notification History"
}
-->

# Get Notification History

Get a list of notifications that the App Store server attempted to send to your server.

## Discussion

Call this endpoint to get a paginated list of the version 2 <doc://com.apple.documentation/documentation/AppStoreServerNotifications> that the App Store attempted to send to your server’s <doc://com.apple.documentation/documentation/AppStoreServerNotifications/App-Store-Server-Notifications-V2> endpoint in a specified timespan. Notification history is available for the past 180 days in the production environment, and the past 30 days in the sandbox environment.

You can further limit the request by specifying a `notificationType` or `notificationSubtype` in the [`NotificationHistoryRequest`](/documentation/AppStoreServerAPI/NotificationHistoryRequest) object. Alternatively, to get the notification history for a single user, provide a `transactionId`. The response, [`NotificationHistoryResponse`](/documentation/AppStoreServerAPI/NotificationHistoryResponse), contains the full contents of the original notifications.

Each time you call this endpoint, it returns a maximum of 20 notification history records. If the [`hasMore`](/documentation/AppStoreServerAPI/hasMore) field in the [`NotificationHistoryResponse`](/documentation/AppStoreServerAPI/NotificationHistoryResponse) is `true`, use the [`paginationToken`](/documentation/AppStoreServerAPI/Get-Notification-History/paginationToken) from the response in your subsequent request to get the next set of records. Use the same [`NotificationHistoryRequest`](/documentation/AppStoreServerAPI/NotificationHistoryRequest) body on subsequent requests.

This endpoint is available in the production and sandbox environments. For more information about configuring App Store Server Notifications, see <doc://com.apple.documentation/documentation/AppStoreServerNotifications/enabling-app-store-server-notifications> and [Enter a URL for App Store server notifications](https://help.apple.com/app-store-connect/#/dev0067a330b).

> Note:
> For notifications that relate to in-app purchases, the history records reflect the state of an in-app purchase at the time the App Store originally sent the notification, and may not reflect its current state. To get the current state of auto-renewable subscriptions, call the ``doc://com.apple.appstoreserverapi/documentation/AppStoreServerAPI/Get-All-Subscription-Statuses`` endpoint. For all other in-app purchase types, call the ``doc://com.apple.appstoreserverapi/documentation/AppStoreServerAPI/Get-Transaction-History`` endpoint.

---

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)