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

# NotificationHistoryRequest

The request body for notification history.

```
object NotificationHistoryRequest
```

## Discussion

Specify the constraints for the App Store Server Notification history entries you’re requesting from [`Get Notification History`](/documentation/AppStoreServerAPI/Get-Notification-History). The request requires the `startDate` and `endDate` fields; all other fields are optional. Include only the fields in your request that you need to constrain the response.

If you provide both the `notificationType` and `subtype`, they need to be a valid combination, otherwise, the request returns an [`InvalidNotificationTypeError`](/documentation/AppStoreServerAPI/InvalidNotificationTypeError) error. For more information, see <doc://com.apple.documentation/documentation/AppStoreServerNotifications/notificationType> and <doc://com.apple.documentation/documentation/AppStoreServerNotifications/subtype>.

> Note:
> Notification history is available for the past 180 days in the production environment, and the past 30 days in the sandbox environment. Choose a `startDate` that’s within the past 180 days in the production environment, and within the past 30 days in the sandbox environment.

## Topics

### Data types

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

The start date of a timespan, expressed in UNIX time, in milliseconds.

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

The end date of a timespan, expressed in UNIX time, in milliseconds.

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

A notification type value that App Store Server Notifications 2 uses.

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

A notification subtype value that App Store Server Notifications 2 uses.

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

A Boolean value that indicates whether the response includes only notifications that failed to reach your server.


---

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)