---
title: "List Pre-Chargeback Alerts"
method: GET
path: "/payments/pre-chargeback-alerts/alerts"
tags: ["Payments", "Pre-Chargeback Alerts"]
---

# List Pre-Chargeback Alerts

`GET /payments/pre-chargeback-alerts/alerts`

## Request

- Base URL: `https://api.evervault.com`
- URL: `https://api.evervault.com/payments/pre-chargeback-alerts/alerts`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/evervault/apis/evervault-api/docs/payments/pre-chargeback-alerts/alerts/get.ts> (a function with typed inputs; its response is checked against the schema)

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

Unknown query parameters are rejected with a `400`.

## Query parameters

- `status` 'ACTION_REQUIRED' | 'RESOLVED' | 'INVALID'
- `merchantId` string
- `alertReceivedAtGte` string, date-time
- `alertReceivedAtLte` string, date-time
- `sort` '-alertReceivedAt' | 'alertReceivedAt' | '-actionRequiredDeadline' | 'actionRequiredDeadline'
- `limit` integer
- `offset` integer

## Response `200`

Returns a paginated list of Pre-Chargeback Alert objects.

- object
  - `items` PreChargebackAlert[], required
    - `id` string, required: A unique identifier for the alert.
    - `merchantId` string, required: The Evervault Merchant ID associated with the alert.
    - `alertType` 'ETHOCA_ALERT' | 'VERIFI_RDR', required: The alert network that originated the alert.
    - `alertNetworkId` string, nullable: The alert identifier from the alert network.
    - `status` 'ACTION_REQUIRED' | 'RESOLVED' | 'INVALID', required: The current status of the alert. `ACTION_REQUIRED` only applies to Ethoca alerts.
    - `chargebackReasonCode` string, nullable: The reason code identifying why the dispute was raised.
    - `transactionAmountInCents` integer, nullable: The disputed transaction amount in cents.
    - `transactionCurrencyCode` string, nullable: The ISO 4217 currency code of the disputed transaction.
    - `transactionAuthorizedAt` string, date-time, nullable: When the transaction was authorized, as an ISO 8601 timestamp in UTC.
    - `actionRequiredDeadline` string, date-time, nullable: The deadline by which an Ethoca alert must be actioned. After this time the chargeback proceeds regardless of whether you refunded the customer.
    - `transactionAuthorizationCode` string, nullable: The authorization code for the disputed transaction.
    - `transactionAcquirerReferenceNumber` string, nullable: The Acquirer Reference Number (ARN). Useful when communicating with your PSP to identify the transaction.
    - `transactionStatementDescriptor` string, nullable: The descriptor that appeared on the cardholder's statement.
    - `transactionCardBin` string, nullable: The first 6–11 digits of the card number. Also included in `card.bin`.
    - `card` object, nullable: Card details for the disputed transaction, when available.
      - `bin` string, nullable: The BIN/IIN of the card.
      - `lastFour` string, nullable: The last four digits of the card number.
      - `brand` string, nullable: The card scheme (for example `VISA` or `MASTERCARD`).
      - `issuer` string, nullable: The issuing bank name.
    - `transactionRefundOutcome` 'REFUNDED' | 'NOT_REFUNDED' | 'null', nullable: Populated when a refund outcome is known. For Verifi RDR, this is set automatically.
    - `transactionNetworkId` string, nullable: The network transaction identifier, when available.
    - `subscriptionCancelOutcome` string, nullable: The outcome of a subscription cancellation, when available.
    - `note` string, nullable: An optional note stored with the alert for your own records.
    - `integrationId` string, nullable: An optional integration identifier associated with the alert.
    - `integrationTransactionId` string, nullable: An optional integration transaction identifier associated with the alert.
    - `createdAt` string, date-time, required: When the alert was created, as an ISO 8601 timestamp in UTC.
  - `count` integer, required: The total number of alerts matching the filters.

## Other responses

- `400`: Invalid or unknown query parameters.
- `404`: Pre-chargeback alerts have not been configured for the app.

## Changes

- **2026-11-06** `8d0ca833fa04`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/evervault/apis/evervault-api/changes/payments/pre-chargeback-alerts/alerts/get.md)

---

[API](https://skmtc.dev/evervault/apis/evervault-api.md) - [All operations](https://skmtc.dev/evervault/apis/evervault-api/llms.txt) - [OpenAPI document](https://skmtc.dev/evervault/apis/evervault-api/revisions/8d0ca833fa04?raw)