EVevervault
Payments
Pre-Chargeback Alerts

List Pre-Chargeback Alerts

Returns a paginated list of pre-chargeback alerts for your app.

Unknown query parameters are rejected with a 400.

get/payments/pre-chargeback-alerts/alerts

Request

Query parameters

status'ACTION_REQUIRED' | 'RESOLVED' | 'INVALID'

Filter by alert status.

merchantIdstring
Example:merchant_eead1d640d7c

Filter by Evervault Merchant ID.

alertReceivedAtGtestring date-time
Example:2025-02-01T00:00:00Z

Return alerts received on or after this ISO 8601 timestamp (inclusive). Filters on the alert's createdAt timestamp; the alertReceivedAt naming is kept for compatibility with the legacy alert-network proxy.

alertReceivedAtLtestring date-time
Example:2025-02-28T23:59:59Z

Return alerts received on or before this ISO 8601 timestamp (inclusive). Must be greater than or equal to alertReceivedAtGte when both are provided. Filters on the alert's createdAt timestamp; the alertReceivedAt naming is kept for compatibility with the legacy alert-network proxy.

sort'-alertReceivedAt' | 'alertReceivedAt' | '-actionRequiredDeadline' | 'actionRequiredDeadline'

Sort order for the results. alertReceivedAt sorts on the alert's createdAt timestamp; the alertReceivedAt naming is kept for compatibility with the legacy alert-network proxy. Alerts without an actionRequiredDeadline sort last when ascending (actionRequiredDeadline) and first when descending (-actionRequiredDeadline).

limitinteger

Number of results per page.

offsetinteger

Pagination offset.

Response

Returns a paginated list of Pre-Chargeback Alert objects.

countinteger required

The total number of alerts matching the filters.

Example response

{
  "items": [
    {
      "id": "pre_chargeback_alert_eead1d640d7c",
      "merchantId": "merchant_eead1d640d7c",
      "alertType": "ETHOCA_ALERT",
      "alertNetworkId": "1234567890",
      "status": "ACTION_REQUIRED",
      "chargebackReasonCode": "10.4",
      "transactionAmountInCents": 4999,
      "transactionCurrencyCode": "USD",
      "transactionAuthorizedAt": "2025-02-10T10:30:00Z",
      "actionRequiredDeadline": "2025-02-17T10:30:00Z",
      "transactionAuthorizationCode": "ABC123",
      "transactionAcquirerReferenceNumber": "74027012345678901234567",
      "transactionStatementDescriptor": "EXAMPLE STORE",
      "transactionCardBin": "424242",
      "card": {
        "bin": "424242",
        "lastFour": "4242",
        "brand": "VISA",
        "issuer": "Example Bank"
      },
      "transactionRefundOutcome": null,
      "transactionNetworkId": null,
      "subscriptionCancelOutcome": null,
      "note": "Customer requested immediate review",
      "integrationId": null,
      "integrationTransactionId": null,
      "createdAt": "2025-02-11T10:30:00Z"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.