---
title: "Management API"
url: "https://docs.adyen.com/release-notes/management-api"
source_url: "https://docs.adyen.com/release-notes/management-api.md"
canonical: "https://docs.adyen.com/release-notes/management-api"
last_modified: "2021-12-06T10:44:00+01:00"
language: "en"
---

# Management API

On this page, you can find all changes in our [Management API](https://docs.adyen.com/api-explorer/Management/latest/overview). For an overview of the changes, you can filter the release notes by version and release date.

You can also use the [API Diff Tool](https://docs.adyen.com/api-explorer/api-diff-tool) to compare any two versions of an API.

[![](/user/themes/adyen-docs/assets/icons/rss.svg) Get updates by RSS](/release-notes/management-api.xml)

## Available filters

Version..., Release date...

## 2023-10-17 — Management API — Version 3

### New

* You can now [assign terminals](/point-of-sale/automating-terminal-management/assign-terminals-api/) using the POST [/terminals/{terminalId}/reassign](https://docs.adyen.com/api-explorer/Management/latest/post/terminals/\(terminalId\)/reassign) call.

### New

* You can now retrieve and update the [restartHour](https://docs.adyen.com/api-explorer/Management/latest/patch/companies/\(companyId\)/terminalSettings#request-hardware-restartHour) of your payment terminal.

### New

* You can now configure the event notification button on the payment terminal screen using the parameter [showButton](https://docs.adyen.com/api-explorer/Management/latest/patch/terminals/\(terminalId\)/terminalSettings#request-nexo-notification-showButton).

### New

* You can now query the GET [/companies/{companyId}/androidApps](https://docs.adyen.com/api-explorer/Management/latest/get/companies/\(companyId\)/androidApps) call by the [packageName](https://docs.adyen.com/api-explorer/Management/latest/get/companies/\(companyId\)/androidApps#responses-200-data-packageName), [packageName](https://docs.adyen.com/api-explorer/Management/latest/get/companies/\(companyId\)/androidApps#responses-200-data-packageName) and the [versionCode](https://docs.adyen.com/api-explorer/Management/latest/get/companies/\(companyId\)/androidApps#responses-200-data-versionCode) of the Android app.

### New

* You can now query the GET [/companies/{companyId}/androidCertificates](https://docs.adyen.com/api-explorer/Management/latest/get/companies/\(companyId\)/androidCertificates) call by the [certificateName](https://docs.adyen.com/api-explorer/Management/latest/get/companies/\(companyId\)/androidCertificates#query-certificateName) of the Android certificate.

### New

* We added two new payment method webhooks: [paymentMethodRequest.scheduledForRemoval](https://docs.adyen.com/api-explorer/ManagementNotification/latest/post/paymentMethodRequest.scheduledForRemoval) and [paymentMethodRequest.removed](https://docs.adyen.com/api-explorer/ManagementNotification/latest/post/paymentMethodRequest.removed).

### Breaking Changes

* For the [/merchants/{merchantId}/stores](https://docs.adyen.com/api-explorer/Management/latest/get/merchants/\(merchantId\)/stores) endpoint, we now validate the format of the [phoneNumber](https://docs.adyen.com/api-explorer/Management/latest/post/stores#request-phoneNumber) parameter against [E.164](https://en.wikipedia.org/wiki/E.164).

### Breaking Changes

* You can now provide a CNPJ number as a [externalReferenceId](https://docs.adyen.com/api-explorer/Management/latest/post/stores#responses-200-data-externalReferenceId) when creating a store.

### Breaking Changes

* For the GET [/terminals](https://docs.adyen.com/api-explorer/Management/latest/get/terminals) call, we replaced `companyAccount` parameter with `companyId` and removed the `storeStatus` parameter.

### Breaking Changes

* When making a POST [/merchants/{merchantId}/stores](https://docs.adyen.com/api-explorer/Management/latest/post/merchants/\(merchantId\)/stores) call to create a store, you now get a HTTP status code 200 instead of 201.

### Breaking Changes

* For the [/merchants/{merchantId}/paymentMethodSettings](https://docs.adyen.com/api-explorer/Management/latest/get/merchants/\(merchantId\)/paymentMethodSettings) endpoint, we renamed the `storeId` request and response parameters to [storeIds](https://docs.adyen.com/api-explorer/Management/latest/post/merchants/\(merchantId\)/paymentMethodSettings#responses-200-storeIds).

### Breaking Changes

* We removed the `PaymentMethod` object from the `data` array of the GET [/merchants/{merchantId}/paymentMethodSettings](https://docs.adyen.com/api-explorer/Management/latest/get/merchants/\(merchantId\)/paymentMethodSettings) call. The list of supported payment methods is now inside the [data](https://docs.adyen.com/api-explorer/Management/latest/get/merchants/\(merchantId\)/paymentMethodSettings#responses-200-data) array.