# JPMC-PDP Documentation from https://developer.payments.jpmorgan.com

# Retrieve notifications

In this guide, you will learn how to:

- Retrieve a notification by ID

- Retrieve a notification by date range and status

## Before you begin

You start receiving notifications after you [subscribe to notifications](/docs/commerce/optimization-protection/capabilities/notifications/how-to/subscribe-notifications). To retrieve these notifications, you need to either know the notificationId, or the date range or notification status of the required notifications.

## Retrieve a specific notification

Retrieve details about a notification by using a `GET` call to the **`/notifications/{notificationId}`** endpoint.

**HTTP method**: `GET`
 **Endpoint**: `/notifications/{notificationId}`

```json
{
    "notificationId": "4444-4017-11e9-b649-8de0642215",
    "merchantId": 9876543210,
    "notificationType": "RecurringProgramNotification",
    "notificationSubType": "PlanUpdated",
    "notificationDescription": "Plan Updated",
    "messageCreateTimestamp": "2020-08-07T09:52:25.686Z",
    "subscriptionId": "3d7e6071-55ea-4e95-b12b-5a79be427b84",
    "callBackUrl": "https://merchant.notification.com",
    "recurringProgramNotification": {
        "planUpdated": {
            "planID": "GH7VoHZHZR",
            "merchantPlanId": "Plan12348",
            "planName": "Gold Plan",
            "planType": "AUTOPAY",
            "planDescription": "Gold Plan Desc",
            "billingFrequencyCount": 1,
            "billingFrequencyUnit": "MONTHS",
            "defaultPlan": true,
            "autoRenewable": false,
            "availableOnCheckout": true,
            "planStatus": "DRAFT",
            "planAmount": 10000,
            "currencyCode": "USD"
        }
    }
}
```

## Retrieve notifications by date and status

You can retrieve notifications by using any of the following filters:

- Date range (in the format YYYY-MM-DD)

- Notification status (which could be SENT, FAILED, or PENDING)

- Both date range and notification status

Retrieve notifications from a specific period by using a `GET` call to the **`/notifications`** endpoint with query parameters indicating the filter applied to the results.

**HTTP method**: `GET`
 **Endpoint**: `/notifications`

Use the following request URL format to apply both date and status filters:** `notifications?startdate=YYYY-MM-DD&enddate=YYYY-MM-DD&status=SENT`**

```json
{
    "notificationResponses": [
        {
            "notificationId": "4444-4017-11e9-b649-8de0642215",
            "merchantId": "9876543210",
            "notificationType": "RecurringProgramNotification",
            "notificationSubType": "PlanUpdated",
            "notificationDescription": "PlanUpdated",
            "messageCreateTimestamp": "2020-08-07T09:52:25.686Z",
            "subscriptionId": "3d7e6071-55ea-4e95-b12b-\t5a79be427b84",
            "callbackURL": "https://merchant.notification.com",
            "recurringProgramNotification": {
                "planUpdated": {
                    "planID": "GH7VoHZHZR",
                    "merchantPlanId": "Plan12348",
                    "planName": "Gold Plan",
                    "planType": "AUTOPAY",
                    "planDescription": "Gold Plan Desc",
                    "billingFrequencyCount": 1,
                    "billingFrequencyUnit": "MONTHS",
                    "defaultPlan": true,
                    "autoRenewable": false,
                    "availableOnCheckout": true,
                    "planStatus": "DRAFT",
                    "planAmount": 10000,
                    "currencyCode": "USD"
                }
            }
        }
    ],
    "responseStatus": "SUCCESS",
    "responseCode": "ACCEPTED",
    "responseMessage": "Request Accepted"
}
```

## Related

[Online Payments API](/docs/commerce/online-payments/index)