# Release History
source: https://developer.mastercard.com/ethoca-alerts-for-merchants/documentation/release-history/index.md

## Recent API Updates {#recent-api-updates}

Here you can find details about changes that were recently made to the Alerts for Merchants APIs.
Alert: For existing integrations, recent changes to the APIs might require updates to your integration.

## August 28, 2026 - Alerts Pull API Released {#august-28-2026---alerts-pull-api-released}

The **Ethoca Alerts for Merchants Pull API** was released August 2026. This new API endpoint allows merchant members of the Ethoca network to pull Ethoca Alerts instead of receiving them through a webhook. The merchant member can then send an acknowledgement that they received the alerts.

For more information about the Pull API, see the following articles:

* [How the Pull API Works](https://developer.mastercard.com/ethoca-alerts-for-merchants/documentation/index.md#how-pull-api-works)

* [Pull API Tutorial](https://developer.mastercard.com/ethoca-alerts-for-merchants/documentation/tutorials-and-guides/pull-api-tutorial/index.md)

* [Retrieve Alerts by Pull, Acknowledge Them, and Submit Outcomes](https://developer.mastercard.com/ethoca-alerts-for-merchants/documentation/use-cases/pull-alert-processing/index.md)

* [Ethoca Alerts Pull API](https://developer.mastercard.com/ethoca-alerts-for-merchants/documentation/api-reference/pull-api-ref/index.md)

## Previous API Updates {#previous-api-updates}

In the Alerts Push API, the following two new fields are now available for merchants who are registered for Mastercard's First-Party Trust program.

* `matchAlgorithm` is under `merchantIdentifiers` and provides details on how a transaction was matched.

* `ftpAssessmentStatus` provides insights on whether compelling evidence exists.

Check out the [Push API Reference](https://developer.mastercard.com/ethoca-alerts-for-merchants/documentation/api-reference/push-api-ref/index.md#apis) for more information about these new fields.
The Ethoca Alerts for Merchants API was released September 2023 and includes these two important services:

* **Alerts Push (Outbound API)**

  The Alerts Push API is a webhook that lets Direct Merchants / Partners receive alerts if they're on the Ethoca network.
* **Alerts Outcome (Inbound API)**

  The Alerts Outcome endpoint lets Direct Merchants / Partners provide necessary outcome and feedback (such as `REFUNDED` and `NOT_SETTLED` messages) via an update that is made available to card issuers so that they know not to raise a chargeback.

See these articles for more details:

* [How it Works](https://developer.mastercard.com/ethoca-alerts-for-merchants/documentation/index.md#how-it-works)
* [Use Cases](https://developer.mastercard.com/ethoca-alerts-for-merchants/documentation/use-cases/index.md)

## Next Steps {#next-steps}

* Review the [API Basics](https://developer.mastercard.com/ethoca-alerts-for-merchants/documentation/api-basics/index.md) to learn about the requirements for connecting to the Alerts for Merchants API.
* Use the [API Reference](https://developer.mastercard.com/ethoca-alerts-for-merchants/documentation/api-reference/index.md) information for details about the fields and values relevant to your specific needs.