---
title: "Retrieve an existing notification subscription configuration."
method: POST
path: "/getNotificationConfiguration"
---

# Retrieve an existing notification subscription configuration.

`POST /getNotificationConfiguration`

This endpoint is used to retrieve the details of the configuration of a notification subscription.

## Request body

- GetNotificationConfigurationRequest
  - `notificationId` integer, required — The ID of the notification subscription configuration whose details are to be retrieved.

## Response `200`

OK - the request has succeeded.

- GetNotificationConfigurationResponse
  - `configurationDetails` NotificationConfigurationDetails, required
    - `active` boolean — Indicates whether the notification subscription is active.
    - `apiVersion` integer — The API version of the notification to send.
    - `description` string — A description of the notification subscription configuration.
    - `eventConfigs` NotificationEventConfiguration[], required — The types of events whose notifications apply to this configuration.
      - `eventType` 'ACCOUNT_CLOSED' | 'ACCOUNT_CREATED' | 'ACCOUNT_FUNDS_BELOW_THRESHOLD' | 'ACCOUNT_HOLDER_CREATED' | 'ACCOUNT_HOLDER_LIMIT_REACHED' | 'ACCOUNT_HOLDER_PAYOUT' | 'ACCOUNT_HOLDER_STATUS_CHANGE' | 'ACCOUNT_HOLDER_STORE_STATUS_CHANGE' | 'ACCOUNT_HOLDER_UPCOMING_DEADLINE' | 'ACCOUNT_HOLDER_UPDATED' | 'ACCOUNT_HOLDER_VERIFICATION' | 'ACCOUNT_UPDATED' | 'BENEFICIARY_SETUP' | 'COMPENSATE_NEGATIVE_BALANCE' | 'DIRECT_DEBIT_INITIATED' | 'PAYMENT_FAILURE' | 'REFUND_FUNDS_TRANSFER' | 'REPORT_AVAILABLE' | 'SCHEDULED_REFUNDS' | 'TRANSFER_FUNDS', required — The type of event triggering the notification. >Permitted values: `ACCOUNT_HOLDER_CREATED`, `ACCOUNT_CREATED`, `ACCOUNT_UPDATED`, `ACCOUNT_HOLDER_UPDATED`, `ACCOUNT_HOLDER_STATUS_CHANGE`, `ACCOUNT_HOLDER_STORE_STATUS_CHANGE`, `ACCOUNT_HOLDER_VERIFICATION`, `ACCOUNT_HOLDER_LIMIT_REACHED`, `ACCOUNT_HOLDER_PAYOUT`, `PAYMENT_FAILURE`, `SCHEDULED_REFUNDS`, `REPORT_AVAILABLE`, `TRANSFER_FUNDS`, `BENEFICIARY_SETUP`, `COMPENSATE_NEGATIVE_BALANCE`.
      - `includeMode` 'EXCLUDE' | 'INCLUDE', required — Indicates whether the specified eventType is to be sent to the endpoint or all events other than the specified eventType (and other specified eventTypes) are to be sent. >Permitted values: `INCLUDE`, `EXCLUDE`. >- `INCLUDE`: send the specified eventType. >- `EXCLUDE`: send all eventTypes other than the specified eventType (and other eventTypes marked with `EXCLUDE`).
    - `messageFormat` 'JSON' | 'SOAP' — The data format of the notification to be sent. >Permitted values: `JSON`, `SOAP`.
    - `notificationId` integer — The ID of the configuration. >Required if updating an existing configuration, ignored during the creation of a configuration.
    - `notifyPassword` string — The password to use when accessing the notifyURL with the specified username.
    - `notifyURL` string, required — The URL to which the notifications are to be sent.
    - `notifyUsername` string — The username to use when accessing the notifyURL.
    - `sendActionHeader` boolean — Indicates whether an action header should be included. >Only applies to SOAP messages (as specified in messageFormat).
    - `sslProtocol` 'SSL' | 'SSLInsecureCiphers' | 'TLS' | 'TLSv10' | 'TLSv10InsecureCiphers' | 'TLSv11' | 'TLSv12' — The SSL protocol employed by the endpoint. >Permitted values: `SSL`, `SSLInsecureCiphers`, `TLS`, `TLSv10`, `TLSv10InsecureCiphers`, `TLSv11`, `TLSv12`.
  - `pspReference` string — The reference of a request. Can be used to uniquely identify the request.
  - `resultCode` string — The result code.
  - `submittedAsync` boolean — Indicates whether the request is processed asynchronously. Depending on the request's platform settings, the following scenarios may be applied: * **true**: The request is queued and will be executed when the providing service is available in the order in which the requests are received. * **false**: The processing of the request is immediately attempted; it may result in an error if the providing service is unavailable.

## Other responses

- `400` — Bad Request - a problem reading or understanding the request.
- `401` — Unauthorized - authentication required.
- `403` — Forbidden - insufficient permissions to process the request.
- `422` — Unprocessable Entity - a request validation error.
- `500` — Internal Server Error - the server could not process the request.

## Changes

- **2021-04-10** (v1) `fa01a51bf28a` — 5 info
  - added the optional property `status` to the response with the `400` status
  - added the optional property `status` to the response with the `401` status
  - added the optional property `status` to the response with the `403` status
  - added the optional property `status` to the response with the `422` status
  - …1 more
- **2021-03-26** (v1) `988c95b5257a` — 5 info
  - added the non-success response with the status `400`
  - added the non-success response with the status `401`
  - added the non-success response with the status `403`
  - added the non-success response with the status `422`
  - …1 more
- **2021-03-05** (v1) `f3953c93f7d9` — 1 warning
  - added the new `ACCOUNT_FUNDS_BELOW_THRESHOLD` enum value to the `configurationDetails/eventConfigs/items/eventType` response property for the response status `200`
- **2020-08-05** (v1) `2104e92047bc` — 2 breaking, 1 warning, 2 info
  - the response property `pspReference` became optional for the status `200`
  - the response property `submittedAsync` became optional for the status `200`
  - added the new `REFUND_FUNDS_TRANSFER` enum value to the `configurationDetails/eventConfigs/items/eventType` response property for the response status `200`
  - api operation id `post-getNotificationConfiguration` was added
  - …1 more
- …earlier changes not shown

[Full history](https://skmtc.dev/adyen/apis/notificationconfigurationservice/changes/getNotificationConfiguration/post.md)

---

[API](https://skmtc.dev/adyen/apis/notificationconfigurationservice.md) · [All operations](https://skmtc.dev/adyen/apis/notificationconfigurationservice/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/adyen/notificationconfigurationservice/revisions/fa01a51bf28a/schema)