# Ethoca Alerts Pull API
source: https://developer.mastercard.com/ethoca-alerts-for-merchants/documentation/api-reference/pull-api-ref/index.md

## Ethoca Alerts for Merchants Pull API Reference {#ethoca-alerts-for-merchants-pull-api-reference}

The Ethoca Alerts for Merchants Pull API lets Direct Merchants / Partners who are on the Ethoca network pull Ethoca Alerts and then acknowledge that they received the pulled alerts.

## Environment Domains {#environment-domains}

### Pull Alerts {#pull-alerts}

* Sandbox
* Production

```Sandbox
https://sandbox.api.ethocaweb.com/ethoca/alerts/merchant/alerts
```

```Production
https://api.ethocaweb.com/ethoca/alerts/merchant/alerts
```

### Acknowledge Alerts {#acknowledge-alerts}

* Sandbox
* Production

```Sandbox
https://sandbox.api.ethocaweb.com/ethoca/alerts/merchant/alerts/acknowledges
```

```Production
https://api.ethocaweb.com/ethoca/alerts/merchant/alerts/acknowledges
```

## How it Works {#how-it-works}

* An issuer sends an alert about a problem transaction to the Alerts platform.
* We process and match the alert, and you pull it using the `/alerts` endpoint.
* Through the `/alerts/acknowledges` endpoint, you send an acknowledgement response to us and we pass that information on to the issuer.

Diagram how-it-works-pull

## APIs {#apis}

Note: The API request below shows example data for each individual field. Test cases are available to use in the sandbox, which include sets of request data that return expected responses. Contact your [Ethoca Customer Delivery Team](mailto:customerdelivery@ethoca.com) for details.
API Specification: `https://static.developer.mastercard.com/content/ethoca-alerts-for-merchants/swagger/alert-delivery-outcome-specs_inbound.yaml`

### Error handling {#error-handling}

See [Code and Formats](https://developer.mastercard.com/ethoca-alerts-for-merchants/documentation/code-and-formats/index.md) for detailed information about error response handling for the Alerts for Merchants APIs.