# Release History
source: https://developer.mastercard.com/rpps-biller-maintenance-service/documentation/release/index.md

## Description {#description}

This page contains pre-release notes for the Biller Maintenance Service, providing early warning of intended changes and additions to the APIs. Only once the API update has been released to production will the specification be updated in the main API reference page. So the pre-release notes are the only place where coming changes are documented in advance of each Biller Maintenance Service production release.
Note: The Biller Maintenance Service content of any given release may change due to the agile nature of development. In such cases the relevant pre-release documentation will be updated accordingly. Every effort will be made to provide as much warning of change as possible, with a target of providing at least 3 months' notice.

## Release History {#release-history}

|                                                                                 **Open API Spec Version**                                                                                 | **Release Date** |                                  **Notes**                                  |
|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------|-----------------------------------------------------------------------------|
| Version 1.0                                                                                                                                                                               | 08/28/2023       | Initial release of Biller Maintenance Service                               |
| Version 2.0                                                                                                                                                                               | 06/15/2024       | Introduced new endpoint get Biller Work Request Status                      |
| Version 3.0                                                                                                                                                                               | 07/14/2025       | Introduced new endpoints Get Biller Details, Edit Biller, Deactivate Biller |
| Version 4.0 - [rpps-biller-maintenance-service.yaml](https://static.developer.mastercard.com/content/rpps-biller-maintenance-service/swagger/rpps-biller-maintenance-service.yaml) (46KB) | 08/20/2025       | Updated YAML field for deactivation flow                                    |

## Backward compatibility {#backward-compatibility}

Mastercard would like to clarify the 'backward compatibility' concept. Adding a new field in an API response is considered to be backward compatible, as we expect all our partners to code their solution to support additional fields. However, the following cases are considered as 'backward breaking':   

1. Marking a required field as optional outbound calls (from Biller Maintenance Service). Marking an optional field as required on an inbound request (to Biller Maintenance Service).   
2. Removing a required field (however: removing an optional field would be backward-compatible)   
3. Adding a required field to an inbound call.