--- title: Get Notification History framework: appstoreserverapi role: symbol role_heading: Web Service Endpoint path: appstoreserverapi/get-notification-history --- # Get Notification History Get a list of notifications that the App Store server attempted to send to your server. ## URL POST https://api.storekit.apple.com/inApps/v1/notifications/history ## Sandbox URL POST https://api.storekit-sandbox.apple.com/inApps/v1/notifications/history ## Query Parameters paginationToken: An optional token you use to get the next set of up to 20 notification history records. All responses that have more records available include a paginationToken. Note: Omit this parameter the first time you call this endpoint. ## Response Codes 200 OK: Request succeeded. 400 Bad Request: Invalid request. 401 Unauthorized: The JSON Web Token (JWT) in the authorization header is invalid. For more information, see Generating JSON Web Tokens for API requests. 404 Not Found: 429 : The request exceeded the rate limit. 500 Internal Server Error: Server error. Try again later. ## Mentioned in App Store Server API changelog Identifying rate limits ## Discussion Discussion Call this endpoint to get a paginated list of the version 2 App Store Server Notifications that the App Store attempted to send to your server’s 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 object. Alternatively, to get the notification history for a single user, provide a transactionId. The response, 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 field in the NotificationHistoryResponse is true, use the paginationToken from the response in your subsequent request to get the next set of records. Use the same 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 Enabling App Store Server Notifications and Enter a URL for App Store server notifications. 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 Get All Subscription Statuses endpoint. For all other in-app purchase types, call the Get Transaction History endpoint. ## HTTP Body The request body that includes the start and end dates, and optional query constraints. ## See Also ### App Store Server Notifications history - [NotificationHistoryRequest](appstoreserverapi/notificationhistoryrequest.md) - [NotificationHistoryResponse](appstoreserverapi/notificationhistoryresponse.md) - [notificationHistoryResponseItem](appstoreserverapi/notificationhistoryresponseitem.md)