<!--
{
  "availability" : [
    "App Store Server API: 1.5.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "AppStoreServerAPI",
  "identifier" : "/documentation/AppStoreServerAPI/NotificationHistoryResponse",
  "metadataVersion" : "0.1.0",
  "role" : "Object",
  "symbol" : {
    "kind" : "Object",
    "modules" : [
      "App Store Server API"
    ],
    "preciseIdentifier" : "data:app_store_server_api:NotificationHistoryResponse"
  },
  "title" : "NotificationHistoryResponse"
}
-->

# NotificationHistoryResponse

A response that contains the App Store Server Notifications history for your app.

```
object NotificationHistoryResponse
```

## Discussion

The [`Get Notification History`](/documentation/AppStoreServerAPI/Get-Notification-History) endpoint returns this response. Notification history records contain the notifications that the App Store server attempted to send to your server’s <doc://com.apple.documentation/documentation/AppStoreServerNotifications/App-Store-Server-Notifications-V2> endpoint.

The notification history response contains a maximum of 20 notification history records per response. If the history has more than 20 records, the [`hasMore`](/documentation/AppStoreServerAPI/NotificationHistoryResponse/hasMore) value is `true`. Call [`Get Notification History`](/documentation/AppStoreServerAPI/Get-Notification-History) again with `paginationToken` in the query to receive the next page of responses. When the App Store has no more records to send, the `hasMore` value is `false`.

> Note:
> The notifications in 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.

## Topics

### Data types

[`paginationToken`](/documentation/AppStoreServerAPI/paginationToken)

A pagination token that you return to the endpoint on a subsequent call to receive the next set of results.

[`hasMore`](/documentation/AppStoreServerAPI/hasMore)

A Boolean value indicating whether the App Store has more transaction data.


---

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)